Skip to main content
Returns trades initiated via /secure/sell or /secure/buy. tradeId accepts either the internal trade id or the externalId you supplied at creation. Scoped to the calling merchant — another merchant’s trade or a client-source trade is treated as not found. Authentication: Merchant API Key (api-key header) Scope: CORE_ACCESS

Request (single)

A single ref returns one Trade object, or 404 TRADE_NOT_FOUND if it doesn’t resolve.

Fetching multiple (batch)

Comma-separate up to 100 ids/externalIds to fetch several in one call — ideal for polling the status of multiple pending withdrawals without one request per trade.
With more than one ref the data is an array of the trades that resolved. Unresolved refs are simply omitted (no 404), so compare the returned externalIds against what you asked for to find the gaps.
(wd_3 didn’t resolve, so it’s absent from the array.)

Rate Limits

Errors