Trades
Get Trade
Fetches a single trade by ID. Returns 404 until the indexer has written the row.
GET
Overview
Returns theTrade record for a trade_id. Because GRAIL’s indexer is the sole writer of trade rows, this endpoint returns 404 until the transaction has confirmed on-chain and been indexed (typically 10–15 seconds on devnet after submit).
Partner-scoped — returns 403 partner_mismatch if the trade belongs to a different partner.
Headers
string
required
A valid
PARTNER scope key.Path Parameters
string
required
Trade identifier (prefixed
trd_).Response
string
Trade identifier.
string
"buy" or "sell".string
Final status written by the indexer:
"confirmed" or "failed".number
USDC amount (input on buys, output on sells). For
failed trades, the value is from the transaction’s memo; the opposing side and fees are 0 because the on-chain program never computed them.number
$GOLD amount (output on buys, input on sells). Same caveat on failed trades.number
Gold price at the time the on-chain program executed.
integer
Fee rate applied, in basis points.
number
Fee in USDC.
string
Solana transaction signature (base58).
string
ISO-8601 timestamp of row creation (when the indexer wrote the trade).
string
ISO-8601 timestamp of most recent update.