redis-matching-engine-server

Implement matching engine by lua script, run in redis

export lua function

The exchange.lua sha256 value is ${EXCHANGE_LUA_HASH}.

`deposit_for_user`

deposit for user.

${USER_ID}: user's id
${SYMBOL}: symbol
${AMOUNT}: deposit amount

return true or false.

redis-cli> eval "local e = f_${EXCHANGE_LUA_HASH}(); \
  return e.deposit_for_user(ARGV[1], ARGV[2], ARGV[3] );" \
  0 ${USER_ID} ${SYMBOL} ${AMOUNT}
1) true

`submit_order`

submit order to the order book, but do not match.

${USER_ID}: user' id
${SYMBOL}: base currency
${CURRENCY}: quote currency
${SIDE}: order side, such as buy or sell
${PRICE}: order price
${AMOUNT}: order amount
${TS}: order create timestamp, unit is ms.

return the order id.

redis-cli> eval "local e = f_${EXCHANGE_LUA_HASH}(); \
  return e.submit_order(ARGV[1], ARGV[2], ARGV[3], ARGV[4], ARGV[5], ARGV[6], ARGV[7] );" \
  0 ${USER_ID} ${SYMBOL} ${CURRENCY} ${SIDE} ${PRICE} ${AMOUNT} ${TS}
1) 10001

`cancel_order`

remove the order from order book, and release the frozen asset for user.

${ORDER_ID}: the order id which will be canceled.

return 1 if success.

redis-cli> eval "local e = f_${EXCHANGE_LUA_HASH}(); \
  return e.cancel_order(ARGV[1]);" \
  0 ${ORDER_ID}
1) 1

`match_order`

trigger match order.

${SYMBOL}: base currency
${CURRENCY}: quote currency
${LIMIT}: hom mach size of the order will take from order book for match.
${TS}: match timestamp, unit is ms.

return the size of order which be executed.

redis-cli> eval "local e = f_${EXCHANGE_LUA_HASH}(); \
  return e.match_order(ARGV[1], ARGV[2], ARGV[3], ARGV[4] );" \
  0 ${SYMBOL} ${CURRENCY} ${LIMIT} ${TS}
1) 1

`get_order_json`

get order json string.

${ORDER_ID}: order id

return the order json string

redis-cli> eval "local e = f_${EXCHANGE_LUA_HASH}(); \
  return e.get_order_json(ARGV[1]);" \
  0 ${ORDER_ID}

response such as follow:

{
  "id": 1,
  "user_id": 1,
  "side": "buy",
  "stock_id": "BTC",
  "money_id": "USDT",
  "price": 4000.00,
  "amount": 1.0,
  "money": 4000.00,
  "process_amount": 0.0,
  "process_money": 0.0,
  "create_time": 1,
  "update_time": 1,
  "status": "create"
}

status: order status, the value is create, part, cancel, finish

`get_depth_json`

get the depth json string.

${SYMBOL}: base currency
${CURRENCY}: quote currency
${LIMIT}: depth size

redis-cli> eval "local e = f_${EXCHANGE_LUA_HASH}(); \
  return e.get_depth_json(ARGV[1], ARGV[2], ARGV[3] );" \
  0 ${SYMBOL} ${CURRENCY} ${LIMIT}

response such as follow:

{
  "asks": [
    [4000, 1],
    [4001, 1],
  ],
  "bids":[
    [3999, 1],
    [3998, 1],
  ]
}

`get_last_price`

get the last match price.

${SYMBOL}: base currency
${CURRENCY}: quote currency

return the last price.

redis-cli> eval "local e = f_${EXCHANGE_LUA_HASH}(); \
  return e.get_last_price(ARGV[1], ARGV[2] );" \
  0 ${SYMBOL} ${CURRENCY}
1) 4000.00

ink-splatters / redis-matching-engine-server Goto Github PK