Sandbox version
For experimental use only. Proceed with caution.
tokens
Get details for the ledger's native currency (XRP)
get
/token/native
operationId: token-getNativeDetails

XRP is the native currency of the XRP Ledger — it has no issuer, no trust lines, and no XRP-denominated price (it is the quote unit itself). Returns total supply (from the latest validated ledger), aggregate trading volume across every indexed pair, exchange counts, and distinct-taker counts over 24h/7d windows. IOU-only fields (trustlines, holders, price, marketcap) are intentionally absent.

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>`.
Responses
200
application/json
Successful response
FieldTypeDescription
currency
string
Always the literal string `XRP`.
issuer
null
XRP has no issuer — always `null`.
metadata
object
Metadata container mirroring the non-native tokenDetail shape.
metadata.token
object
XRP token metadata.
metadata.token.name
string
Display name (always `XRP`).
metadata.token.ticker
string
Display ticker (always `XRP`).
metadata.token.desc
string
Short description of the native asset.
metadata.token.icon
object
URL to the XRP logo.
metadata.token.asset_class
string
Always the literal `native`.
metadata.token.trust_level
number
Always `3` — the native asset is fully trusted.
metadata.token.urls
object[]
External links (ledger site, docs, …).
metadata.token.urls[].url
string
Absolute URL.
metadata.token.urls[].type
string
URL category, e.g. `website`, `social`, `whitepaper`.
metrics
object
Ledger-wide metrics for the native asset.
metrics.supply
string
Total XRP in existence in drops, from the latest validated ledger.
metrics.volume_24h
string
Summed XRP volume across every indexed trade pair over the last 24h.
metrics.volume_7d
string
Summed XRP volume across every indexed trade pair over the last 7d.
metrics.exchanges_24h
integer
Trade count across all pairs over the last 24h.
metrics.exchanges_7d
integer
Trade count across all pairs over the last 7d.
metrics.takers_24h
integer
Distinct taker addresses that participated in any pair over the last 24h.
metrics.takers_7d
integer
Distinct taker addresses that participated in any pair over the last 7d.
Example
Json
{
  "currency": "string",
  "issuer": null,
  "metadata": {
    "token": {
      "name": "string",
      "ticker": "string",
      "desc": "string",
      "icon": "string",
      "asset_class": "string",
      "trust_level": 0,
      "urls": [
        {
          "url": "string",
          "type": "string"
        }
      ]
    }
  },
  "metrics": {
    "supply": "string",
    "volume_24h": "string",
    "volume_7d": "string",
    "exchanges_24h": 0,
    "exchanges_7d": 0,
    "takers_24h": 0,
    "takers_7d": 0
  }
}
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": []
}
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": []
}