Trade Settlement APIs
Report a trade [deprecated]
Report a trade to the platform for a pair of accounts, on a given symbol. The trade report will cause collateral to be reserved for the counterparty accounts, and the exposures on each account to be updated. The trade will be recorded in the unsettled state.
Request method
ts/trades/report
Parameters
| Field | Type | Description |
|---|---|---|
| symbol | string | The security identifier of the trade. |
| buyer_id | string | The account identifier of the buying account. |
| seller_id | string | The account identifier of the selling account. |
| qty | number | The agreed quantity of the trade, from the buyer's perspective. |
| price | number | The agreed price of the trade. |
Response
| Field | Type | Description |
|---|---|---|
| tid | number | The unique identifier of the trade. |
| createTime | number | A timestamp when the trade was created. |
| updateTime | number | A timestamp when the trade was last updated. |
| symbol | string | The security identifier of the trade. |
| buyer_account_id | string | The account identifier of the buying account. |
| seller_account_id | string | The account identifier of the selling account. |
| qty | number | The agreed quantity of the trade, from the buyer's perspective. |
| price | number | The agreed price of the trade. |
ts/fix/trades/report {"tradeReportId":"144396769585101347_C","transactTime":"20220322-14:19:07.520","trdSubType":"1","lastPx":"0.99470132","lastQty":"10000.0","symbol":"USDT/USD","side":2,"account":"JX10592DP","currency":"USDT"}
Report a trade
Report a trade to the platform for a pair of accounts, on a given symbol. The trade report will cause collateral to be reserved for the counterparty accounts, and the exposures on each account to be updated. The trade will be recorded in the unsettled state, but will be queued for automated settlement where possible.
This API endpoint should be called twice - once for each account. The Etana platform will match the two trade reports in order to confirm the accounting relationship and queue it for settlement.
Request method
ts/fix/trades/report
Parameters
| Field | Type | Description |
|---|---|---|
| tradeReportId | string | A unique client-side identifier for the trade |
| transactTime | string | The trade time in the form YYYYMMDD-HH:MM:SS.SSS |
| trdSubType | string | "1" for price taker (or client side), or "2" for price maker (or LP side) |
| lastPx | string | The price of the trade, in string form |
| lastQty | string | The amount of the trade, in string form |
| symbol | string | The symbol identifier for the traded pair |
| side | string | The direction of the trade, "1" for buy, "2" for sell |
| account | string | The account identifier for this counterparty |
| currency | string | The currency used to specify the amount of the trade |
Response
When the platform receives two matching trade reports, it will respond with an array of trades registered within the system, of the form described below.
| Field | Type | Description |
|---|---|---|
| tid | number | The unique identifier of the trade. |
| createTime | number | A timestamp when the trade was created. |
| updateTime | number | A timestamp when the trade was last updated. |
| symbol | string | The security identifier of the trade. |
| buyer_account_id | string | The account identifier of the buying account. |
| seller_account_id | string | The account identifier of the selling account. |
| qty | number | The agreed quantity of the trade, from the buyer's perspective. |
| price | number | The agreed price of the trade. |