trades
Get the latest XRP-denominated price snapshot for a token
get
/trade/quote
operationId: trade-quote

Latest XRP-denominated price + 24h/7d windowed metrics for a token. For candles, use /trade/ohlcv. Returns a single object keyed on tokenSlug (or mptIssuanceId); per-token rollups (volume, change, market cap, takers) are sourced from token_metrics_v and token_xrp_price_v, including the stablecoin-bridged shortcut. Tokens without an XRP-paired ohlcv source return priceXrp: null with volume24hXrp: 0. Pass an optional timestamp (Unix-seconds) to fetch the historical close at that moment via the OHLCV CAGG ladder (5m → 1h → 1d, last-known-price fallback); when set, the response carries priceXrp + lastCloseAt (the materialised bucket consulted) and nullifies / zeroes the live-only windowed metrics.

Unlock protected endpoints

Enter your Bearer token once to enable every protected route in this API reference.

HTTP bearer

Saved for this browser tab only. The credential is never sent until you test an endpoint.

Authorizations
NameLocationDetails
BearerAuthAuthorization header · bearerJWT issued by the Honeycluster auth service for the `indexer` audience. Present as `Authorization: Bearer <token>`.
Query Parameters
NameTypeDefaultDescription
tokenSlug
string
mptIssuanceId
string
timestamp
integer
Responses
200
application/json
Successful response
FieldTypeDescription
tokenSlug
string
Echoed token identifier (`XRP` for native, `currency.issuer` otherwise).
priceXrp
object
Latest XRP-denominated price for the token. NULL when the token has no XRP-paired ohlcv data.
priceChange5mPct
object
Price change vs the close 5 minutes ago, as a percentage decimal string. NULL when no 5m-old close exists.
priceChange1hPct
object
Price change vs the close 1 hour ago, as a percentage decimal string.
priceChange24hPct
object
Price change vs the close 24 hours ago, as a percentage decimal string.
priceChange7dPct
object
Price change vs the close 7 days ago, as a percentage decimal string.
volume24hXrp
string
XRP-denominated trade volume over the last 24h. `0` when no recent trades.
volume7dXrp
string
XRP-denominated trade volume over the last 7d.
marketCapXrp
object
XRP-denominated market cap (price × circulating supply). NULL when price or supply is unknown.
trades24h
integer
Trade count over the last 24h.
takers24h
integer
Distinct takers over the last 24h (HyperLogLog approx-distinct, ~3% error).
lastCloseAt
object
Timestamp of the most recent ohlcv bucket consulted, Unix-seconds. NULL when no ohlcv data exists.
source
object
Pricing source. `direct` — from the token's own XRP-paired ohlcv. `stablecoin` — borrowed from the freshest priced stablecoin (bridged-pricing shortcut). NULL when no price is available.
Example
Json
{
  "tokenSlug": "string",
  "priceXrp": "string",
  "priceChange5mPct": "string",
  "priceChange1hPct": "string",
  "priceChange24hPct": "string",
  "priceChange7dPct": "string",
  "volume24hXrp": "string",
  "volume7dXrp": "string",
  "marketCapXrp": "string",
  "trades24h": 0,
  "takers24h": 0,
  "lastCloseAt": 1745798400,
  "source": "direct"
}
400
application/json
Invalid input data
FieldTypeDescription
message
string
The error message
code
string
The error code
issues
object[]
An array of issues that were responsible for the error
issues[].message
string
Example
Json
{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}
401
application/json
Authorization not provided
FieldTypeDescription
message
string
The error message
code
string
The error code
issues
object[]
An array of issues that were responsible for the error
issues[].message
string
Example
Json
{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}
403
application/json
Insufficient access
FieldTypeDescription
message
string
The error message
code
string
The error code
issues
object[]
An array of issues that were responsible for the error
issues[].message
string
Example
Json
{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}
404
application/json
Not found
FieldTypeDescription
message
string
The error message
code
string
The error code
issues
object[]
An array of issues that were responsible for the error
issues[].message
string
Example
Json
{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}
500
application/json
Internal server error
FieldTypeDescription
message
string
The error message
code
string
The error code
issues
object[]
An array of issues that were responsible for the error
issues[].message
string
Example
Json
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}