Get order details

Rate limit: every seconds

API Overview

HTTP method

GET

Path

/api/v3/order

Summary

Get the details of an order based on order hash.

API description

HTTP Header

Field Type Required Description Example
X-API-KEY string Y ApiKey "HlkcGxbqBeaF76j4rvPaOasyfPwnkQ
6B6DQ6THZWbvrAGxzEdulXQvOKLrRW
ZLnN"

Request parameters

Field Type Required Description Example
accountId integer Y Account ID 1
orderHash string Y Order hash "13375450901292179417
15497484957179306991
15173547203971250276
33242680470075859"

Request example

HTTP
CURL
GET http://aa90cd58e38014a1b864ddc488129b7a-624979106.us-east-2.elb.amazonaws.com/api/v3/order?accountId=1&orderHash=13375450901292179417154974849571793069911517354720397125027633242680470075859 HTTP/1.1
Host: aa90cd58e38014a1b864ddc488129b7a-624979106.us-east-2.elb.amazonaws.com
Connection: keep-alive
Accept: */*
Accept-Encoding: gzip, deflate, br
Accept-Language: zh,en;q=0.9
X-API-KEY: sra1aavfa
curl -H "X-API-KEY:sra1aavfa" http://aa90cd58e38014a1b864ddc488129b7a-624979106.us-east-2.elb.amazonaws.com/api/v3/order\?accountId\=1\&orderHash\=13375450901292179417154974849571793069911517354720397125027633242680470075859

Response fields

Field Type Required Description Example
hash string Y Order hash "0xfb5e711c2f044e9432
2ed262229cd8f0d0da00
c22e1a00a0f5d881e45a
38e1cf"
clientOrderId string Y Order's client-side ID "200310143135081332"
side string Y Order's side
Allowable : ['SELL', 'BUY']		 "SELL"
market string Y Trading pair "LRC-ETH"
price string Y Order price "0.01987608"
volumes OrderVolumesV3 Y Wraps data regarding the orders volumes (base, quote, and filled.) "0"
validity OrderValidityV3 Y Wraps data regarding time validity constraints (since and until) "{start: 1234, end: 2345}"
orderType string Y Whether the order has to be treated as a limit, maker, or taker operation.
Allowable : ['LIMIT_ORDER', 'TAKER_ONLY', 'MAKER_ONLY']		 "LIMIT_ORDER"
status string Y Order status
Allowable : ['processing', 'processed', 'cancelling', 'cancelled', 'expired', 'waiting']		 "processing"

Response example

{
    "hash" : "0xfb5e711c2f044e94322ed262229cd8f0d0da00c22e1a00a0f5d881e45a38e1cf",
    "clientOrderId" : "200310143135081332",
    "side" : "SELL",
    "market" : "LRC-ETH",
    "price" : "0.01987608",
    "volumes" : {
        "baseAmount" : "0",
        "quoteAmount" : "0",
        "baseFilled" : "0",
        "quoteFilled" : "0",
        "fee" : "0"
    },
    "validity" : {
        "start" : 0,
        "end" : 0
    },
    "orderType" : "LIMIT_ORDER",
    "status" : "processing"
}

Status code

Value Description
100000 Unknown error
107001 User ID cannot be empty
107002 Order Hash cannot be empty
107003 Order does not exist
104001 Empty ApiKey
104002 Invalid ApiKey
104003 Invalid Account ID

Model

OrderVolumesV3

Wraps data regarding the orders volumes (base, quote, and filled.)

Field Type Required Description Example
baseAmount string Y The amount of base tokens involved in the order. "0"
quoteAmount string Y The amount of quote tokens involved in the order. "0"
baseFilled string Y The amount of requested base tokens filled in the order. "0"
quoteFilled string Y The amount of requested quote tokens filled in the order. "0"
fee string Y The amount of quote or base token amount used to pay for the orders fee. Whether this data refers to the base or quote token, one can find out by looking at the orders side "0"

OrderValidityV3

Wraps data regarding time validity constraints (since and until

Field Type Required Description Example
start integer Y Timestamp from when the order officially becomes valid and fillable 0
end integer Y Timestamp from when the order ceases to be valid and fillable 0

results matching ""

    No results matching ""