Retrieve Trade
Retrieves a trade. Read it until its status is completed, failed or in_review.
Authorizations
An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.
Headers
Pins the request to a dated API version.
"2026-10-15"
Path Parameters
Trade ID, prefixed tint_.
Response
trade retrieved
The account that owns the trading wallet, prefixed biz_. null when a user owns it.
"biz_xxxxxxxxxxxxxx"
The USDT0 that a deposit, or an order short of trading balance, sends from the wallet, or the USDC that a withdraw sends back, in native units, as a decimal string. A withdraw of all shows what it sent once it finishes. null otherwise.
"25"
The average fill price of the order, in USD, as a decimal string. null when it is not known.
null
The caller's own ID for the trade, unique for the account. null when none was sent.
null
When the trade ended as completed or failed, as an ISO 8601 timestamp. null before that.
null
When the trade was created, as an ISO 8601 timestamp.
"2026-01-01T12:00:00.000Z"
Why the trade failed, or null.
market_unavailable, leverage_too_high, amount_too_small, isolated_position_open, trading_paused, funding_failed, margin_unavailable, builder_fee_unapproved, leverage_rejected, leverage_unconfirmed, order_rejected, close_rejected, return_failed, withdraw_failed, null "market_unavailable"
The size the order filled, in units of the market, as a decimal string. null until it fills.
null
Where the money is when the trade did not complete as asked: wallet, trading_account, or unknown while a person checks it. null otherwise.
wallet, trading_account, unknown, null "wallet"
Trade ID, prefixed tint_.
"tint_xxxxxxxxxxxxxx"
perpetual or spot for an order, perpetual for a close. null for a deposit or withdraw.
perpetual, spot, null "perpetual"
The cross leverage set before an opening perpetual order. null for a spot order, close, deposit, withdraw or reduce-only order.
10
The market, for example BTC for a perpetual or HYPE/USDC for spot. null for a deposit or withdraw.
"BTC"
Free-form string-to-string annotations stored on the trade.
trade "trade"
market or limit for an order. null otherwise.
market, limit, null "market"
The limit price of the order in USD. A market order's price is the mid price moved by slippage_bps. null for other types.
Whether the order can only reduce a position. null for other types.
null
buy or sell for an order. null otherwise.
buy, sell, null "buy"
The order size in units of the market, as a decimal string. null for other types.
null
pending until the trade starts. processing while it runs, also while an order that did not fill sends the money it bridged in back to the wallet. completed when it did what was asked. failed when it did not; funds_location says where the money is. in_review when the outcome is unknown and a person checks it.
pending, processing, in_review, completed, failed "pending"
partial_fill when the order filled only part of its size. null otherwise.
partial_fill, null "partial_fill"
order places one order from the trading balance. deposit bridges USDT0 from the wallet to the trading balance. withdraw sends USDC from the trading balance back to the wallet. close closes the whole position in one market with a market reduce-only order; when the account is then flat, a withdraw trade sends the trading balance back to the wallet.
close, order, deposit, withdraw "order"
When the trade last changed, as an ISO 8601 timestamp.
"2026-01-01T12:00:00.000Z"
The user who owns the trading wallet, prefixed user_. null when an account owns it.
null

