Query Latest Withdrawal Transaction State

Check the latest withdrawal transaction state of certain order ID.

Request

GET /v1/sofa/wallets/{WALLET_ID}/sender/transactions/{ORDER_ID}

Response Body

FieldTypeDescription
order_idstringThe unique ID specified in sender/transactions API
addressstringOutgoing address
amountstringWithdrawal amount
memostringMemo on blockchain
in_chain_blockint64The block that contains this transaction
txidstringTransaction ID
create_timestringThe withdrawal unix time in UTC

Error Code

HTTP CodeError CodeErrorMessageDescription
403-Forbidden. Invalid wallet ID-No wallet ID found
403-Forbidden. Header not found-Missing X-API-CODE, X-CHECKSUM header or query param t
403-Forbidden. Invalid timestamp-The timestamp t is not in the valid time range
403-Forbidden. Invalid checksum-The request is considered a replay request
403-Forbidden. Invalid API code-X-API-CODE header contains invalid API code
403-Invalid API code for wallet {WALLET_ID}-The API code mismatched
403-Forbidden. Checksum unmatch-X-CHECKSUM header contains wrong checksum
403-Forbidden. Call too frequently ({THROTTLING_COUNT} calls/minute)-Send requests too frequently
404304Wallet ID invalid-The {ORDER_ID} not found

Sample Request

API

/v1/sofa/wallets/1/sender/transactions/1

Response Body

{
  "order_id": "1",
  "address": "0xaa0cA2f9bA3A33a915a27e289C9719adB2ad7d73",
  "amount": "1.11",
  "memo": "",
  "in_chain_block": 1016603,
  "txid": "db0f3a27de564a411aeff1d2cb3234c54817de1ecc2258a510a50c5a1063d41c",
  "create_time": "2020-03-16T10:27:57Z"
}

Sample cURL Command

curl -X GET http://localhost:8889/v1/mock/wallets/{WALLET_ID}/sender/transactions/{ORDER_ID}