Honeycluster Data API
OpenAPI-compliant REST API for indexed XRPL data
Spechttp://localhost:4100/openapi.json
Base URL
All endpoints below are relative to one of these hosts. Prefix each path with the base URL when making requests.
https://api.honeycluster.dev/data/v1
auth
get
/auth
Start interactive sign-in
post
/auth/jwt
Exchange an API key for a JWT, or start interactive sign-in
tokens
get
/token/list
List tokens
get
/token/search
Search tokens
get
/token/{tokenSlug}
Get a token detail by tokenSlug
post
/token/batch
Get multiple token details by tokenSlugs
get
/token/native
Get details for the ledger's native currency (XRP)
get
/token/{tokenSlug}/metadata
Get curated metadata + indicators for a token
post
/token/metadata/batch
Fetch curated metadata + indicators for many tokens
get
/token/{tokenSlug}/metrics
Get rolling market state for a token
post
/token/metrics/batch
Fetch rolling market state for many tokens
get
/token/by-issuer
List tokens by issuer
get
/token/{tokenSlug}/holders/info
Get holder concentration metrics for a token
post
/token/holder-concentration/batch
Fetch top-N holder concentration percentages for many tokens
get
/token/{tokenSlug}/holders/history
Get daily holder-count history for a token
post
/token/holder-history/batch
Fetch daily holder-count history for many tokens
get
/token/{tokenSlug}/risk
Get risk score and advisory flags for a token
post
/token/risk/batch
Fetch risk + advisory flags for many tokens in one call
get
/token/{tokenSlug}/flow
Get creator-distribution BFS graph for a token
post
/token/flow/batch
Fetch creator-distribution graphs for many tokens
mptokens
get
/mpt/list
List MPTokens
get
/mpt/search
Free-text search over MPT issuances
get
/mpt/{issuanceId}
Get an MPT issuance by ID (canonical)
post
/mpt/batch
Batch lookup MPT issuances by ID
get
/mpt/{issuanceId}/metadata
Get just the metadata half of an MPT detail
post
/mpt/metadata/batch
Batch metadata-only lookup by IDs
get
/mpt/{issuanceId}/metrics
Get just the metrics half of an MPT detail
post
/mpt/metrics/batch
Batch metrics-only lookup by IDs
get
/mpt/holders
List holders of an MPT issuance
get
/mpt/holder-balance
Get a specific holder's balance
get
/mpt/transfers
List transfers for an MPT issuance
get
/mpt/supply-history
Get supply-delta history for an issuance
get
/mpt/issuances
List MPT issuances
get
/mpt/issuances/page
List MPT issuances (page-mode)
get
/mpt/issuance/{issuanceId}
Get an MPT issuance (raw row)
get
/mpt/by-token/{issuanceId}
Get an MPT issuance detail (token-shaped response)
post
/mpt/issuances/batch
Batch resolve MPT issuances by ID
nftokens
get
/nft/list
List NFTs
get
/nft/search
Free-text search across NFTs and collections
get
/nft/collections
List NFT collections
get
/nft/by-collection
List NFTs within a collection
get
/nft/collection/{nftId}
Get an NFT collection by NFTokenID
get
/nft/{nftId}
Get an NFT detail by NFTokenID
post
/nft/batch
Batch lookup NFT details by NFTokenIDs
get
/nft/by-mint/{txHash}
Get an NFT by mint transaction hash
post
/nft/by-mints
Batch lookup NFTs by mint transaction hash
get
/nft/by-owner/{address}
List NFTs owned by an address (optionally scoped to a collection)
get
/nft/offers
List offers for an NFT
get
/nft/by-offer/{offerId}
Get an NFT by NFTokenOffer ID
post
/nft/by-offers
Batch lookup NFTs by offer ID
get
/nft/collection/{slug}/traits
Get trait breakdown for a collection
get
/nft/collection/{slug}/holders
List holders for a collection
get
/nft/collection/{slug}/traders
List top traders for an NFT collection
get
/nft/collection/{slug}/activity
Recent activity feed for a single NFT collection
get
/nft/collections-by-owner/{address}
List collections held by an address, with owned counts and sample tokens
get
/nft/assets/urls
Get CDN asset URLs for an NFT
post
/nft/assets/urls/batch
Get CDN asset URLs for multiple NFTs
get
/nft/transfers
List transfer history for an NFT
get
/nft/trades
List NFT sales
get
/nft/trader/{account}
Get an account's cumulative NFT trading profile
get
/nft/sales-history
Get bucketed NFT sales time series
get
/nft/collection/{slug}/floor/history
Get hourly floor-price history for a collection
get
/nft/activity
Unified recent NFT activity feed
trades
get
/trade/list
Page-based list of trades with sort + direction
get
/trade/ohlcv
Get OHLCV candles for a trade pair
get
/trade/sparkline
Get a 24h sparkline price series for a token
post
/trade/sparkline/batch
Fetch hourly close-price sparklines for many tokens in one call
get
/trade/quote
Get the latest XRP-denominated price snapshot for a token
post
/trade/quote/batch
Fetch latest token prices for many tokens in one call
get
/trade/{id}
Get a single trade by ID
post
/trade/batch
Batch resolve trades by IDs
get
/trade/orderbook
Get a live orderbook snapshot
get
/trade/pair/{id}
Get a trade pair (market) by ID
post
/trade/pairs/batch
Batch resolve trade pairs by IDs
post
/liquidity/orderbook-depth
Get aggregated orderbook depth for a pair
get
/trade/pairs
List trade pairs (markets)
post
/liquidity/pair-liquidity
Get combined AMM + orderbook liquidity for a pair
get
/trader/{account}/token/{tokenSlug}
Get per-account per-token trading stats
get
/trader/{account}
Get a trader's cumulative trading profile
amm
get
/liquidity/pools
List liquidity pools
get
/liquidity/pools/search
Free-text search for AMM pools
get
/amm/{ammId}
Get an AMM pool detail by ammId
post
/amm/batch
Batch lookup AMM pools by ammId
get
/liquidity/events
List raw pool events (all types)
get
/liquidity/swaps
List swap events for a pool
get
/liquidity/deposits
List deposit events for a pool
get
/liquidity/withdrawals
List withdrawal events for a pool
get
/liquidity/pools/by-asset
List pools containing a given asset
get
/liquidity/pool-timeseries
Get historical reserves / LP supply / TVL for a pool
get
/amm/by-owner/{address}
List pools created by an AMM owner address
get
/amm/{ammId}/holders
List LP-token holders for an AMM pool
get
/amm/{ammId}/holder-concentration
Top-N LP-holder concentration percentages
get
/amm/trader/{account}
Get an account's AMM activity profile
get
/liquidity/pool-ohlcv
Get pool OHLCV candles for any interval (1m → 1M)
accounts
get
/accounts/list
List accounts
get
/accounts/search
Search accounts
post
/accounts/batch
Batch resolve account profiles by address
get
/accounts/tracked
List tracked accounts
get
/accounts/well-known
List accounts with curated metadata
post
/accounts/track
Register an address for tracking
get
/accounts/{account}/ancestry
Get the funding ancestry graph for an account
get
/accounts/{address}/events
List balance events for an account
get
/accounts/{address}/balances
List current portfolio balances + XRP-equivalent value
get
/accounts/{address}/balance-history
List bucketed balance history for an account
get
/accounts/{address}/flow-history
List daily flow history split by event type
get
/accounts/{address}/network
List counterparties for an account
get
/accounts/{address}
Get an account profile
get
/watchlists
List watchlists
post
/watchlists
Create a watchlist
post
/watchlists/{slug}/members
Add an address to a watchlist
get
/watchlists/{slug}
Get a watchlist by slug
network
get
/network/ledger-info
List ledger headers
get
/network/metrics
Get bucketed network throughput metrics
get
/network/validators
List validators
get
/network/validators/page
List validators (page-mode)
get
/network/fee-history
Get bucketed network fee history
get
/network/accounts-churn
Get bucketed new/deleted account counts
get
/network/supply-history
Get daily XRP supply open/close + burn
get
/ledger/fee
Get live network fee snapshot
get
/ledger/tx/{hash}
Look up a transaction by hash
platform
get
/platform/stats
Get platform-wide stats
get
/platform/source-tags
Rank SourceTags by attributed volume
oracles
get
/oracles
List oracles
get
/oracles/price-history
Get oracle price history
post
/oracles/batch
Batch lookup oracles by oracleIds
get
/oracles/{oracleId}
Get an oracle detail by oracleId
richlist
get
/richlist/native
Paginated richlist of XRP holders
get
/richlist/native/info
XRP richlist distribution: range buckets + top-N percentile thresholds
get
/richlist/native/timeseries
XRP richlist concentration evolution over time
get
/richlist/token/{tokenSlug}
Paginated richlist for a token
get
/richlist/token/{tokenSlug}/info
Token richlist distribution: %-of-supply buckets + top-N percentile thresholds
get
/richlist/token/{tokenSlug}/timeseries
Per-token richlist concentration evolution over time
get
/richlist/mpt/{issuanceId}
Paginated richlist for an MPT issuance
get
/richlist/mpt/{issuanceId}/info
MPT richlist distribution: %-of-supply buckets + top-N percentile thresholds
get
/richlist/mpt/{issuanceId}/timeseries
Per-MPT richlist concentration evolution over time
composite
get
/composite/search
Unified search across tokens, MPTs, NFTs, collections, and accounts
get
/composite/list
Page-paginated list combining IOU tokens and MPTs