# MagnEx Product API

Field Value
HTTP_SERVER_ENDPOINT https://ex.movapi.com/magnet

# Get trading pairs

Returns all trading pair information from the MOV

# Request

GET /v3/common/symbols

# Response

Field Type Description
price_decimal String Price decimal of trading pairs
amount_decimal String Amount decimal of trading pairs
base_asset Object The object of the base asset
asset_id String The id of the asset
symbol String The name of the asset
quote_asset Object The object of the quote asset
asset_id String The id of the asset
symbol String The name of the asset
  • Example:
# Request
GET https://ex.movapi.com/magnet/v3/common/symbols

# Response
{
   "code":200,
   "msg":"",
   "data":[
      {
         "price_decimal":4,
         "amount_decimal":2,
         "base_asset":{
            "asset_id":"ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "symbol":"BTM"
         },
         "quote_asset":{
            "asset_id":"184e1cc4ee4845023888810a79eed7a42c02c544cf2c61ceac05e176d575bd46",
            "symbol":"USDT"
         }
      },
      {
         "price_decimal":2,
         "amount_decimal":4,
         "base_asset":{
            "asset_id":"78de44ffa1bce37b757c9eae8925b5f199dc4621b412ef0f3f46168865284a93",
            "symbol":"ETH"
         },
         "quote_asset":{
            "asset_id":"184e1cc4ee4845023888810a79eed7a42c02c544cf2c61ceac05e176d575bd46",
            "symbol":"USDT"
         }
      },
      {
         "price_decimal":8,
         "amount_decimal":2,
         "base_asset":{
            "asset_id":"ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "symbol":"BTM"
         },
         "quote_asset":{
            "asset_id":"78de44ffa1bce37b757c9eae8925b5f199dc4621b412ef0f3f46168865284a93",
            "symbol":"ETH"
         }
      },
      {
         "price_decimal":8,
         "amount_decimal":2,
         "base_asset":{
            "asset_id":"ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "symbol":"BTM"
         },
         "quote_asset":{
            "asset_id":"bda946b3110fa46fd94346ce3f05f0760f1b9de72e238835bc4d19f9d64f1742",
            "symbol":"BTC"
         }
      },
      {
         "price_decimal":2,
         "amount_decimal":4,
         "base_asset":{
            "asset_id":"bda946b3110fa46fd94346ce3f05f0760f1b9de72e238835bc4d19f9d64f1742",
            "symbol":"BTC"
         },
         "quote_asset":{
            "asset_id":"184e1cc4ee4845023888810a79eed7a42c02c544cf2c61ceac05e176d575bd46",
            "symbol":"USDT"
         }
      },
      {
         "price_decimal":6,
         "amount_decimal":4,
         "base_asset":{
            "asset_id":"78de44ffa1bce37b757c9eae8925b5f199dc4621b412ef0f3f46168865284a93",
            "symbol":"ETH"
         },
         "quote_asset":{
            "asset_id":"bda946b3110fa46fd94346ce3f05f0760f1b9de72e238835bc4d19f9d64f1742",
            "symbol":"BTC"
         }
      }
   ]
}

# Get Klines

This endpoint retrieves all klines in a specific range.

# Request

GET /market/v3/kline

# Params

Name Required Type Description Value Range
symbol true String The trading symbol to query BTM/USDT, ETH/BTC...
period true String The period of each candle 1min, 5min, 15min, 30min, 60min, 4hour, 1day, 1mon, 1week, 1year
size false Int The number of data returns [1, 500]
end_timestamp false Int Get the Klines data before the specified time

# Response

Name Type Description
amount String Trading volume
open String The opening price
close String The closing price
low String The low price
high String The high price
block_height String This period of maximum block height
timestamp String The unit is second, the start time of the cycle, and use this as the id of this Klines
indicator Object The object of indicator
├── change String Change in price, open price -close price
└── change_rate String Rate of price change

Example:

# Request
GET https://ex.movapi.com/magnet/v3/market/kline?symbol=BTM/ETH&period=60min&size=10
# Response
{
    "code": 200,
    "msg": "",
    "data": [
        {
            "amount": "103371.6655444115",
            "open": "0.0000479300",
            "close": "0.0000476700",
            "low": "0.0000479200",
            "high": "0.0000475100",
            "block_height": 94363563,
            "timestamp": 1611810000,
            "indicator": {
                "change": "-0.0000002600",
                "change_rate": "-0.54246"
            }
        },
        {
            "amount": "15165.2609106430",
            "open": "0.0000479400",
            "close": "0.0000479300",
            "low": "0.0000478700",
            "high": "0.0000480000",
            "block_height": 94359948,
            "timestamp": 1611806400,
            "indicator": {
                "change": "-0.0000000100",
                "change_rate": "-0.02086"
            }
        },
        {
            "amount": "30438.1731260001",
            "open": "0.0000481500",
            "close": "0.0000479400",
            "low": "0.0000478300",
            "high": "0.0000482400",
            "block_height": 94352749,
            "timestamp": 1611802800,
            "indicator": {
                "change": "-0.0000002100",
                "change_rate": "-0.43614"
            }
        },
        {
            "amount": "11510.7676104221",
            "open": "0.0000483900",
            "close": "0.0000481500",
            "low": "0.0000480700",
            "high": "0.0000483900",
            "block_height": 94345555,
            "timestamp": 1611799200,
            "indicator": {
                "change": "-0.0000002400",
                "change_rate": "-0.49597"
            }
        },
        {
            "amount": "62396.3848495016",
            "open": "0.0000478300",
            "close": "0.0000483900",
            "low": "0.0000478300",
            "high": "0.0000484600",
            "block_height": 94338360,
            "timestamp": 1611795600,
            "indicator": {
                "change": "0.0000005600",
                "change_rate": "1.17081"
            }
        },
        {
            "amount": "29632.6091818503",
            "open": "0.0000478700",
            "close": "0.0000478300",
            "low": "0.0000478200",
            "high": "0.0000483500",
            "block_height": 94331160,
            "timestamp": 1611792000,
            "indicator": {
                "change": "-0.0000000400",
                "change_rate": "-0.08356"
            }
        },
        {
            "amount": "37243.7229185097",
            "open": "0.0000478200",
            "close": "0.0000478700",
            "low": "0.0000477900",
            "high": "0.0000480000",
            "block_height": 94323962,
            "timestamp": 1611788400,
            "indicator": {
                "change": "0.0000000500",
                "change_rate": "0.10456"
            }
        },
        {
            "amount": "132452.6558909063",
            "open": "0.0000478600",
            "close": "0.0000478200",
            "low": "0.0000472000",
            "high": "0.0000480800",
            "block_height": 94316765,
            "timestamp": 1611784800,
            "indicator": {
                "change": "-0.0000000400",
                "change_rate": "-0.08358"
            }
        },
        {
            "amount": "76665.7064058792",
            "open": "0.0000476500",
            "close": "0.0000478600",
            "low": "0.0000476500",
            "high": "0.0000480300",
            "block_height": 94309565,
            "timestamp": 1611781200,
            "indicator": {
                "change": "0.0000002100",
                "change_rate": "0.44071"
            }
        },
        {
            "amount": "66600.2123452163",
            "open": "0.0000475200",
            "close": "0.0000476500",
            "low": "0.0000470500",
            "high": "0.0000477800",
            "block_height": 94302366,
            "timestamp": 1611777600,
            "indicator": {
                "change": "0.0000001300",
                "change_rate": "0.27357"
            }
        }
    ]
}

# Get market depth

Gets the depth of market-specified trading pairs

# Request

GET /v3/market/depth

# Params

Parameter Required Type Description
symbol yes String Trading pair
depth no Int The market depth of the query, default 20

# Response

Field Type Description
symbol String Trading pair
fee_rate String Transaction fee rate
timestamp Int64 Server timestamp
bids Array Specifies the depth of the purchase price and quantity
asks Array Specifies the depth of sale price and quantity
  • Example:
# Request
GET https://ex.movapi.com/magnet/v3/market/depth?symbol=BTM/USDT&depth=5

# Response
{
   "code":200,
   "msg":"",
   "data":{
      "symbol":"BTM/USDT",
      "fee_rate":"",
      "asks":[
         [
            "0.0620",
            "213.25"
         ],
         [
            "0.0621",
            "26791.91"
         ],
         [
            "0.0622",
            "3401.84"
         ],
         [
            "0.0623",
            "3875.55"
         ],
         [
            "0.0624",
            "27415.30"
         ]
      ],
      "bids":[
         [
            "0.0612",
            "6488.12"
         ],
         [
            "0.0611",
            "6362.57"
         ],
         [
            "0.0610",
            "1731.20"
         ],
         [
            "0.0608",
            "1818.76"
         ],
         [
            "0.0607",
            "299.48"
         ]
      ],
      "timestamp":1589273712400
   }
}

# Build order

Sending an order requires building the transaction first, and building one order can result in multiple transactions on the chain.

Note: The order price and quantity of MOV are based on the former transaction pair. For example, BTC/USDT is based on BTC. If side is buy, BTC will be bought with USDT, and if side is sell, BTC will be exchanged for USDT.

# Request

POST /v3/merchant/build-place-order-tx

# Params

Parameter Required Type Description
address yes String The account address

# Body

Field Required Type Description
price yes String The price of order
amount yes String The amount of order
side yes String buy or sell
symbol yes String Trading pair
pubkey yes String public key

# Response

Field Type Description
tx Object The object of transaction
hash String Transaction hash
status_fail Bool Whether the transaction is an invalid transaction with an exhausted fee
size Int Transaction size
submission_timestamp Int The timestamp of the transaction submission
memo String Memo message
inputs Array UTXO input
script String Script address
address String address
asset String asset ID
amount Int The amount of assets
type String UTXO type
outputs Array UTXO output
script String Script address
address String address
asset String asset ID
amount Int The amount of assets
type String UTXO type
fee Int Transaction Fee
balances Array Change of asset amount
asset String asset ID
amount Int The amount of assets
types Array Transaction type
chain_tx: The deal to merge UTXO
mov_matched_tx: MagnEx contracts are traded
mov_place_order: MagnEx Contract Maker deal
mov_cancel_order: Cancel order
raw_transaction String Transaction information to be signed
signing_instructions Array The information required to sign the transaction
derivation_path Array The derived path
sign_data Array The signature data
pubkey String The public key
  • Example:
# Request
POST https://ex.movapi.com/magnet/v3/merchant/build-place-order-tx?address=vp1qzpm9pqf3phngkv9qnv73tgtr2mzdnxpdswphm3

# Body
{
    "price": "0.02033848",
    "amount": "3",
    "symbol": "BTM/USDT",
    "side": "buy",
    "pubkey":"00140e5b5f38718b477c2d08365de85a5db384767e72"
}

# Response
{
   "code":200,
   "msg":"",
   "data":[
      {
         "tx":{
            "hash":"22e11e644272a370c6ce1797c0d707a00bf7a7d5478519545a8a85bd2de53640",
            "status_fail":False,
            "size":338,
            "submission_timestamp":0,
            "memo":"",
            "inputs":[
               {
                  "script":"0014ba0e092db4cc577fe774d153b59fe7e634623553",
                  "address":"vp1qhg8qjtd5e3thlem569fmt8l8uc6xyd2nmsscks",
                  "asset":"ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
                  "amount":27000000,
                  "type":"spend"
               }
            ],
            "outputs":[
               {
                  "utxo_id":"2843646cb703ba22c80bd0b362b5c09ca64891c666f2086b13844c889fa55f3d",
                  "script":"0020184e1cc4ee4845023888810a79eed7a42c02c544cf2c61ceac05e176d575bd46515a160014ba0e092db4cc577fe774d153b59fe7e63462355320083b80e0259d963abbcd43d0195dfde3c03e50c6fb5e2ee13ff0429de091a2e2",
                  "address":"smart contract",
                  "asset":"ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
                  "amount":1000000,
                  "type":"control"
               },
               {
                  "utxo_id":"3d1e8964a1ca1b86d66e0454b819a2e7b73c63e9c56740899d8478833613d94a",
                  "script":"0014ba0e092db4cc577fe774d153b59fe7e634623553",
                  "address":"vp1qhg8qjtd5e3thlem569fmt8l8uc6xyd2nmsscks",
                  "asset":"ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
                  "amount":26000000,
                  "type":"control"
               }
            ],
            "fee":0,
            "balances":[
               {
                  "asset":"ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
                  "amount":"-1000000"
               }
            ],
            "types":[
               "mov_place_order"
            ]
         },
         "raw_transaction":"07010001015f015defdefb2fe997bda02f87f23721a6a2c4ab7650c959c95fa4cd443549095f55c4ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc0f9ef0c0101160014ba0e092db4cc577fe774d153b59fe7e634623553220120083b80e0259d963abbcd43d0195dfde3c03e50c6fb5e2ee13ff0429de091a2e202018401008101ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc0843d015c0020184e1cc4ee4845023888810a79eed7a42c02c544cf2c61ceac05e176d575bd46515a160014ba0e092db4cc577fe774d153b59fe7e63462355320083b80e0259d963abbcd43d0195dfde3c03e50c6fb5e2ee13ff0429de091a2e200013e003cffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff80f5b20c01160014ba0e092db4cc577fe774d153b59fe7e63462355300",
         "signing_instructions":[
            {
               "derivation_path":[
                  "2c000000",
                  "99000000",
                  "01000000",
                  "00000000",
                  "01000000"
               ],
               "sign_data":[
                  "69f89ff6071a885a86634f8c969d67101ad5f8ef24a8e0f5712cf7415341e50d"
               ],
               "pubkey":"083b80e0259d963abbcd43d0195dfde3c03e50c6fb5e2ee13ff0429de091a2e2"
            }
         ],
         "fee":0
      }
   ]
}

# Submit order

# Request

POST /v3/merchant/submit-place-order-tx

# Params

Parameter Required Type Description
address yes String The account address

# Body

Field Required Type Description
raw_transaction yes String The data returned by the previous build-place-Order-Tx interface
signatures yes Array The signature data

# Response

Field Type Description
transaction_hash String Transaction hash
order Object The object of order
symbol String Trading pair
side String buy or sell
order_id Int Order ID
open_price String Order price
deal_price String Transaction price
amount String Order quantity
filled_amount String Amount of transactions
fee_amount String The amount of fee
status String Order status
open: Open order
partial: Partial order
filled: Filled order
cancelled: Cancelled order
submitted: Submitted order
cancelling: Cancelling order
type String Order type
order_txs Array The trading order contains
hash Order hash
type String Order type
chain_tx: Merge UTXO trading
mov_matched_tx: MagnEx Taker Order
mov_place_order: MagnEx Maker Order
mov_cancel_order: MagnEx Cancel Order
timestamp Int The timestamp of the order
order_timestamp Int When the order was placed
update_timestamp Int Order update time
  • Example:
# Request
POST https://ex.movapi.com/magnet/v3/merchant/submit-place-order-tx?address=vp1qzpm9pqf3phngkv9qnv73tgtr2mzdnxpdswphm3

# Body
{
    "raw_transaction": "070100010160015ef90fd46c6d84fd9ab5820ebd4176cdc3cac71f561f8525c9198a9dc05584b9ded50a426bdaaf1458d161aba4d8c3ebdd095eac7e1bbeb4a0252a3737ccf2d4928094ebdc030201160014aaaa55bb767bfe0190f69ef641555f7e6f8d7cee22012040c7dec75fbfeec1de6f63d3f46a1298509609b3a88f8e63f52bbaf3a7c5de9002018f01008c01d50a426bdaaf1458d161aba4d8c3ebdd095eac7e1bbeb4a0252a3737ccf2d4920301690020a0889e1080999e59ed552865a1d3ee677202796222141ccc3552041708aad76c07a796525ff92e020600480f625e0b160014aaaa55bb767bfe0190f69ef641555f7e6f8d7cee2040c7dec75fbfeec1de6f63d3f46a1298509609b3a88f8e63f52bbaf3a7c5de9000013f003dd50a426bdaaf1458d161aba4d8c3ebdd095eac7e1bbeb4a0252a3737ccf2d492fd93ebdc0301160014aaaa55bb767bfe0190f69ef641555f7e6f8d7cee00",
    "signatures": [
        [
            "d4f5a8e88fd49d46ff1298abcb546405e98949e5c8905cd80359976e7f998216d9c6fbf86e1a44ccdc04dbd8fc026d3b3ceb3b61e290fb9403ce20082a6fed06"
        ]
    ],
}

# Response
{
   "code":200,
   "msg":"",
   "data":{
      "transaction_hash":"22e11e644272a370c6ce1797c0d707a00bf7a7d5478519545a8a85bd2de53640",
      "order":{
         "symbol":"BTM/USDT",
         "side":"sell",
         "order_id":615833,
         "open_price":"10.00000000000000000000",
         "deal_price":"0",
         "amount":"0.01",
         "filled_amount":"0.00",
         "fee_amount":"0.000000",
         "status":"submitted",
         "type":"mov",
         "client_id":"123",
         "order_txs":[
            {
               "hash":"22e11e644272a370c6ce1797c0d707a00bf7a7d5478519545a8a85bd2de53640",
               "type":"mov_place_order",
               "timestamp":1589274014
            }
         ],
         "order_timestamp":1589274014,
         "update_timestamp":1589274014
      }
   }
}

# Build cancel order

# Request

POST /v3/merchant/build-cancel-order-tx

# Body

Field Required Type Description
order_id yes Int Pending cancellations id

# Response

Field Type Description
tx Object The object of order
hash String Transaction hash
status Bool Whether the transaction is an invalid transaction with an exhausted fee
size Int Transaction size
submission_timestamp Int The timestamp of the transaction submission
memo String Memo message
inputs Array UTXO input
script String Script address
address String address
asset Object The object of the asset
asset_id String asset ID
symbol String The name of asset
amount Int The amount of assets
type String UTXO type
outputs Array UTXO output
script String Script address
address String address
asset Object The object of asset
asset_id String asset ID
symbol String The name of asset
amount Int The amount of assets
type String UTXO type
fee Int Transaction Fee
balances Array Change of asset amount
types Array Transaction type
raw_transaction String Transaction information to be signed
signing_instructions Array The information required to sign the transaction
derivation_path Array The derived path
sign_data Array The signature data
  • Example:
# Request
POST https://ex.movapi.com/magnet/v3/merchant/build-cancel-order-tx

# Body
{
    "order_id": 1
}

# Response
{
   "code":200,
   "msg":"",
   "data":{
      "tx":{
         "hash":"10ad8602b5a8f71459394ed076a9f520a7fa54cbf35233febf0f5171fdc14aa2",
         "status":True,
         "size":239,
         "submission_timestamp":0,
         "memo":"",
         "inputs":[
            {
               "script":"0020184e1cc4ee4845023888810a79eed7a42c02c544cf2c61ceac05e176d575bd46515a160014ba0e092db4cc577fe774d153b59fe7e63462355320083b80e0259d963abbcd43d0195dfde3c03e50c6fb5e2ee13ff0429de091a2e2",
               "address":"smart contract",
               "asset":{
                  "asset_id":"ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
                  "symbol":"BTM"
               },
               "amount":"0.01",
               "type":"spend"
            }
         ],
         "outputs":[
            {
               "utxo_id":"964e1ba5f502ab6e4303887f61df76f84793811c19c657c0731f2d643a16379c",
               "script":"0014ba0e092db4cc577fe774d153b59fe7e634623553",
               "address":"vp1qhg8qjtd5e3thlem569fmt8l8uc6xyd2nmsscks",
               "asset":{
                  "asset_id":"ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
                  "symbol":"BTM"
               },
               "amount":"0.01",
               "type":"control"
            }
         ],
         "fee":"0",
         "balances":[
            {
               "asset":{
                  "asset_id":"ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
                  "symbol":"BTM"
               },
               "amount":"0.01"
            }
         ],
         "types":[
            "ordinary"
         ]
      },
      "raw_transaction":"0701000101a50101a2019830463b7e4019a65788edb1cd946fd3de127eda867f04beac81d3a4a05a8ae3ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc0843d00015c0020184e1cc4ee4845023888810a79eed7a42c02c544cf2c61ceac05e176d575bd46515a160014ba0e092db4cc577fe774d153b59fe7e63462355320083b80e0259d963abbcd43d0195dfde3c03e50c6fb5e2ee13ff0429de091a2e2010001013d003bffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc0843d01160014ba0e092db4cc577fe774d153b59fe7e63462355300",
      "signing_instructions":[
         {
            "derivation_path":[
               "2c000000",
               "99000000",
               "01000000",
               "00000000",
               "01000000"
            ],
            "sign_data":[
               "d95058d693b7968bb97c22147ac29029267ccf9fd7c0ccf5b35781ac4760db28"
            ]
         }
      ]
   }
}

# Submit cancel order

# Request

POST /v3/merchant/submit-cancel-order-tx

# Body

Field Required Type Description
raw_transaction yes String The data returned by the previous Cancel-place-Order-Tx interface
signatures yes Array Signature data

# Response

Field Type Description
transaction_hash String Transaction hash
  • Example:
# Request

POST https://ex.movapi.com/magnet/v3/merchant/submit-cancel-order-tx

{
  'raw_transaction': '070100050160015ea36a32db05dde6387a1af256e59dbf549e3388b6e5fe76aec90ad3bc5375673b4483893ef7d9aac788c0e9e49a12398c1d35a2172adb1c8dc551fd169a6f570383fa9ad104010116001449f9cb425163e24791f39e9189a7ef3126a0fe0a22012066fb66a351b651ad70de9bdb1cafa3c95c10fc28d19d627cc3c3e34c090eb4350160015e9e6916db156b3bdeb1053080841967cbfc6ef86ac933667fbb04ca5427b551604483893ef7d9aac788c0e9e49a12398c1d35a2172adb1c8dc551fd169a6f5703e1d4a8ce04010116001449f9cb425163e24791f39e9189a7ef3126a0fe0a22012066fb66a351b651ad70de9bdb1cafa3c95c10fc28d19d627cc3c3e34c090eb4350160015e34fb4bfeb7e6cd6a3ab6d59139783748cec60408f91c7ce296a39d01c5bb29974483893ef7d9aac788c0e9e49a12398c1d35a2172adb1c8dc551fd169a6f5703a9b6b6c004010116001449f9cb425163e24791f39e9189a7ef3126a0fe0a22012066fb66a351b651ad70de9bdb1cafa3c95c10fc28d19d627cc3c3e34c090eb4350160015e4fdb42acd18b165e1622ba3249f6c45cb06b66d2082545b8902c6000f2c02f2a4483893ef7d9aac788c0e9e49a12398c1d35a2172adb1c8dc551fd169a6f5703cdeca9bf04010116001449f9cb425163e24791f39e9189a7ef3126a0fe0a22012066fb66a351b651ad70de9bdb1cafa3c95c10fc28d19d627cc3c3e34c090eb4350160015e2255d1f1b3967ce291c42f020d302b4a3e2b1ad11b45cabe2e5da8ca94fdb8c64483893ef7d9aac788c0e9e49a12398c1d35a2172adb1c8dc551fd169a6f5703c0f79cbe04010116001449f9cb425163e24791f39e9189a7ef3126a0fe0a22012066fb66a351b651ad70de9bdb1cafa3c95c10fc28d19d627cc3c3e34c090eb435020188010085014483893ef7d9aac788c0e9e49a12398c1d35a2172adb1c8dc551fd169a6f570380badadc16015e0020d50a426bdaaf1458d161aba4d8c3ebdd095eac7e1bbeb4a0252a3737ccf2d4925102d41716001449f9cb425163e24791f39e9189a7ef3126a0fe0a2066fb66a351b651ad70de9bdb1cafa3c95c10fc28d19d627cc3c3e34c090eb43500013d003b4483893ef7d9aac788c0e9e49a12398c1d35a2172adb1c8dc551fd169a6f57039aaf660116001449f9cb425163e24791f39e9189a7ef3126a0fe0a00',
  'signatures': [
    ['718a54649e43dcccf3b4e855fd9bf4ea23d5bd05517540eea09e2eb96ebc5b59dcfa4741b3280ec8aae003b276482cb51e2b967087d7821cae5e2d469c245100'],
    ['57032992d83e998325a385d247670175d8fc031e117c54d7b14fb887f276947907321d4cef2a592fb25737092353b96252a9dcb943ab4588a9fde42df32a470e'],
    ['0f521a9fc08b32053cac86e845fae332928d6588aa1039a72c41fe1d9f5418d6a333be2754e83405eed4303ebcb2ddc908792fb3761cd12dcd3154354f64670c'],
    ['8a30dc5d085f701466f3918a88eb5322835860956e33cd8fbb1c3e1afffb8695fe0bc2eac83cd43f365422cdf9e8358af611b3b031b99eb233c984c93fc0c40d'],
    ['7e2d41ddd5b2d15b32375c46cb6807dba4d3d6e6cedb36fef04d4e11a971c1e4495cb0d633738d6113cacc7adb004ab1703f76954d2c952408a509d78d439e0a']
  ],
}

# Response
{
  "code": 200,
  "msg": "",
  "data": {
    "transaction_hash": "9c4d0e3da8b473695a59891329bc2aa92c37d889e4f1c162b8403b691b25c2db"
  }
}

# Query order

The order that meets the criteria is queried by the specified parameters

# Request

POST /v3/merchant/list-orders

# Params

Parameter Required Type Description
address yes String The account address
start no Array Query the start sequence number of the transaction, which defaults to 0
limit no Int Query the number of transactions, which defaults to 10

# Body

Field Required Type Description
symbol yes String Trading pair
side no String Buy or sell, default means all orders
order_type yes String Order type
mov: MagnEx Order
swap: FlashSwap Order
filter String The filter:
open: Open Order
partial: Partial Order
filled: Filled Order
cancelled: Cancelled Order
cancelling: Cancelling Order
submitted: An order that has been submitted but has not been chained and cannot be cancelled

# Response

Field Type Description
symbol String Trading pair
side String buy or sell
order_id Int Order ID
amount String Amount
filled_amount String The amount of Filled asset
open_price String The price of the open order
deal_price String The price of the deal order
status String Order status:
open: Open Order
partial: Partial Order
filled: Filled Order
cancelled: Cancelled Order
cancelling: Cancelling Order
submitted: An order that has been submitted but has not been chained and cannot be cancelled
client_id String Additional order information
order_txs Array An order hash array
hash String Hash
type String Order type
chain_tx: Merge UTXO trading
mov_matched_tx: MagnEx Taker Order
mov_place_order: MagnEx Maker Order
mov_cancel_order: MagnEx Cancel Order
timestamp Int64 Order to database time
order_timestamp Int64 The timestamp of the order creation
update_timestamp Int64 The timestamp of order update
  • Example:
# Request
POST https://ex.movapi.com/magnet/v3/merchant/list-orders?address=vp1qzpm9pqf3phngkv9qnv73tgtr2mzdnxpdswphm3&start=10&limit=10

# Body
{
    "symbol": "ETH/BTC",
    "side": "buy",
    "filter":{
       "states": [
         "open",
         "partial",
         "filled",
         "canceled",
         "cancelling",
         "submitted"
      ],
      "order_type": "mov"
    }
}

# Response
{
   "code":200,
   "msg":"",
   "data":[
      {
         "symbol":"BTM/USDT",
         "side":"sell",
         "order_id":617158,
         "open_price":"10.0000000000",
         "deal_price":"0.0000000000",
         "amount":"0.01",
         "filled_amount":"0.00",
         "fee_amount":"0.000000",
         "status":"open",
         "type":"mov",
         "client_id":"123",
         "order_txs":[
            {
               "hash":"975188691f6e6f561f310bafaabe94b9b9d7355328249939012c9828e51cbfc8",
               "type":"mov_place_order",
               "timestamp":1589278879
            }
         ],
         "order_timestamp":1589278879,
         "update_timestamp":1589278881
      },
      {
         "symbol":"BTM/USDT",
         "side":"sell",
         "order_id":590412,
         "open_price":"10.0000000000",
         "deal_price":"0.0000000000",
         "amount":"1.00",
         "filled_amount":"0.00",
         "fee_amount":"0.000000",
         "status":"open",
         "type":"mov",
         "client_id":"123",
         "order_txs":[
            {
               "hash":"0d53d981f3c2c0721ead4ae7fea22f701b7e5f34b73ed7fb5b1ef8429ee39306",
               "type":"mov_place_order",
               "timestamp":1589182761
            }
         ],
         "order_timestamp":1589182761,
         "update_timestamp":1589182762
      }
   ],
   "pagination":{
      "start":0,
      "limit":1000,
      "_links":{

      }
   }
}
Last Updated: 1/28/2021, 5:25:01 PM