Retrieve Trade
Retrieves a trade. Order acknowledgements don’t update as orders fill; read live orders and positions from the account’s trading field. Never resubmit a submission_unknown trade with a new idempotency key.
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-09-24-1"
Path Parameters
Trade ID, prefixed trop_.
Response
trade retrieved
The account that owns the trading wallet, prefixed biz_. null when a user owns it.
"biz_xxxxxxxxxxxxxx"
When the submission finished, as an ISO 8601 timestamp, or null while it is pending or its outcome is unknown.
"2026-01-01T12:00:00.000Z"
When the trade was submitted, as an ISO 8601 timestamp.
"2026-01-01T12:00:00.000Z"
Why the trade failed or has an unknown outcome, or null otherwise.
pre_submission_error, provider_rejected, provider_outcome_unknown, null "pre_submission_error"
Hyperliquid-specific submission details. Present when provider is hyperliquid, otherwise null.
Trade ID, prefixed trop_.
"trop_xxxxxxxxxxxxxx"
The kind of instrument traded.
perpetual "perpetual"
The leverage requested by an update_leverage trade. null for other trades.
String-to-string annotations you provided when submitting the trade.
trade "trade"
create_orders places orders, cancel_orders cancels a submitted batch, and update_leverage sets a market's leverage.
create_orders, cancel_orders, update_leverage "cancel_orders"
null
Trading venue the trade was submitted to.
hyperliquid "hyperliquid"
Submission status, not fill status. completed means the provider response was recorded, even if individual orders were rejected. Never resubmit a submission_unknown trade with a new idempotency key.
pending, submitted, completed, failed, submission_unknown "completed"
For a cancellation, the ID of the canceled trade, prefixed trop_. null otherwise.
"trop_xxxxxxxxxxxxxx"
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

