Tokens API

Structured token data — search, resolution, market snapshots, OHLCV, risk summaries and asset detail.

Structured token data — search, resolution, market snapshots, OHLCV, risk summaries and asset detail. 17 endpoints, each gated by the x402 payment protocol and settled in USDC. Connect the same endpoints over the MCP server for agent-to-agent use.

Asset Detail

Complete asset details — metadata, variants, market stats. Optionally include profile, risk, OHLCV, or DEX markets.

POST /tokens-api/asset-detail

Price

$0.01

Network

Solana

x402

Request parameters

Parameter	Type	Required	Description
`assetId`	`string`	Yes	Canonical asset slug (e.g. "solana", "usdc") or singleton ID ("solana-<mint>")
`include`	`string`	No	Comma-separated: profile, risk, ohlcv, markets
`mint`	`string`	No	Specific variant mint for include computations
`ohlcvInterval`	`select`	No	Candle interval (only when including ohlcv) One of: `1m`, `5m`, `15m`, `1H`, `4H`, `1D`, `1W`.

Response

Returns full asset detail with imageUrl, primaryVariant, stats, and optional includes (profile, risk, ohlcv, markets)

Example

curl -X POST "https://api.xona-agent.com/tokens-api/asset-detail" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "assetId": "solana",
  "include": "profile,risk",
  "mint": "your_mint_here",
  "ohlcvInterval": "1m"
}'

Asset Profile

Get the asset profile — aggregated statistics, metadata, and external provider data.

POST /tokens-api/asset-profile

Price

$0.01

Network

Solana

x402

Request parameters

Parameter	Type	Required	Description
`assetId`	`string`	Yes	Canonical asset slug or singleton ID

Response

Returns asset profile with external market stats and metadata

Example

curl -X POST "https://api.xona-agent.com/tokens-api/asset-profile" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "assetId": "solana"
}'

Asset Risk Details

Comprehensive risk analysis with detailed scoring inputs for a specific asset variant.

POST /tokens-api/asset-risk-details

Price

$0.01

Network

Solana

x402

Request parameters

Parameter	Type	Required	Description
`assetId`	`string`	Yes	Canonical asset slug or singleton ID
`mint`	`string`	No	Specific variant mint (defaults to primary)

Response

Returns detailed risk analysis with all scoring inputs and breakdown

Example

curl -X POST "https://api.xona-agent.com/tokens-api/asset-risk-details" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "assetId": "solana",
  "mint": "your_mint_here"
}'

Asset Risk Summary

Risk score summary for a specific asset variant — score, grade, and trust flags.

POST /tokens-api/asset-risk-summary

Price

$0.01

Network

Solana

x402

Request parameters

Parameter	Type	Required	Description
`assetId`	`string`	Yes	Canonical asset slug or singleton ID
`mint`	`string`	No	Specific variant mint (defaults to primary)

Response

Returns risk score, grade, label, and trust flags

Example

curl -X POST "https://api.xona-agent.com/tokens-api/asset-risk-summary" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "assetId": "solana",
  "mint": "your_mint_here"
}'

Asset Variants

List all token variants (native, wrapped, bridged, etc.) for a canonical asset with per-variant market data.

POST /tokens-api/asset-variants

Price

$0.01

Network

Solana

x402

Request parameters

Parameter	Type	Required	Description
`assetId`	`string`	Yes	Canonical asset slug or singleton ID
`kind`	`select`	No	Filter by variant type One of: `native`, `wrapped`, `bridged`, `lst`, `stablecoin`.
`trustTier`	`select`	No	Filter by trust tier One of: `tier1`, `tier2`, `experimental`.

Response

Returns asset variants with per-variant market snapshots

Example

curl -X POST "https://api.xona-agent.com/tokens-api/asset-variants" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "assetId": "usdc",
  "kind": "native",
  "trustTier": "tier1"
}'

Bulk Market Snapshots

Bulk lookup cached market snapshots for up to 250 Solana mints in one call.

POST /tokens-api/market-snapshots

Price

$0.01

Network

Solana

x402

Request parameters

Parameter	Type	Required	Description
`mints`	`textarea`	Yes	Comma-separated Solana mint addresses (max 250)

Response

Returns array of token rows with metadata and market snapshot data

Example

curl -X POST "https://api.xona-agent.com/tokens-api/market-snapshots" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "mints": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v, So11111111111111111111111111111111111111112"
}'

Curated Assets

Retrieve curated/pre-assembled asset collections with market data.

POST /tokens-api/curated

Price

$0.01

Network

Solana

x402

Request parameters

Parameter	Type	Required	Description
`list`	`string`	No	Curated list ID or "all" (default: all)
`groupBy`	`string`	No	"asset" (default) or "mint"

Response

Returns curated asset list with market stats

Example

curl -X POST "https://api.xona-agent.com/tokens-api/curated" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "list": "all",
  "groupBy": "asset"
}'

DEX Markets

List DEX market pools for a specific mint of an asset — liquidity, volume, and protocol tokens.

POST /tokens-api/asset-markets

Price

$0.01

Network

Solana

x402

Request parameters

Parameter	Type	Required	Description
`assetId`	`string`	Yes	Canonical asset slug or singleton ID
`mint`	`string`	No	Specific variant mint (defaults to primary)
`offset`	`number`	No	Pagination offset (default 0)
`limit`	`number`	No	Results per page 1-50 (default 10)

Response

Returns DEX markets with liquidity, volume, and protocol token info

Example

curl -X POST "https://api.xona-agent.com/tokens-api/asset-markets" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "assetId": "solana",
  "mint": "your_mint_here",
  "offset": "0",
  "limit": "10"
}'

Exchange Tickers

Get exchange ticker listings for an asset — shows where it trades and at what volume.

POST /tokens-api/asset-tickers

Price

$0.01

Network

Solana

x402

Request parameters

Parameter	Type	Required	Description
`assetId`	`string`	Yes	Canonical asset slug or singleton ID
`offset`	`number`	No	Pagination offset (default 0)
`limit`	`number`	No	Results per page 1-50 (default 10)
`order`	`select`	No	Sort order One of: `volume_desc`.

Response

Returns exchange ticker array with trading pairs and volume

Example

curl -X POST "https://api.xona-agent.com/tokens-api/asset-tickers" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "assetId": "solana",
  "offset": "0",
  "limit": "10",
  "order": "volume_desc"
}'

OHLCV Candles

Get OHLCV (candlestick) price data for a specific mint — configurable interval and time range.

POST /tokens-api/asset-ohlcv

Price

$0.01

Network

Solana

x402

Request parameters

Parameter	Type	Required	Description
`assetId`	`string`	Yes	Canonical asset slug or singleton ID
`mint`	`string`	No	Specific variant mint (defaults to primary)
`interval`	`select`	No	Candle interval One of: `1m`, `5m`, `15m`, `1H`, `4H`, `1D`, `1W`.
`from`	`number`	No	Unix timestamp start (default: 7 days ago)
`to`	`number`	No	Unix timestamp end (default: now)

Response

Returns assetId, mint, interval, and candles array (open, high, low, close, volume)

Example

curl -X POST "https://api.xona-agent.com/tokens-api/asset-ohlcv" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "assetId": "solana",
  "mint": "your_mint_here",
  "interval": "1H",
  "from": 0,
  "to": 0
}'

Price Chart

Get canonical price history chart for an asset — uses external provider data when available, otherwise falls back to on-chain OHLCV.

POST /tokens-api/asset-price-chart

Price

$0.01

Network

Solana

x402

Request parameters

Parameter	Type	Required	Description
`assetId`	`string`	Yes	Canonical asset slug or singleton ID

Response

Returns price chart candle data with assetId, interval, from, to, and candles array

Example

curl -X POST "https://api.xona-agent.com/tokens-api/asset-price-chart" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "assetId": "solana"
}'

Token Description

Get a cached description summary for a specific mint of an asset.

POST /tokens-api/asset-description

Price

$0.01

Network

Solana

x402

Request parameters

Parameter	Type	Required	Description
`assetId`	`string`	Yes	Canonical asset slug or singleton ID
`mint`	`string`	No	Specific variant mint (defaults to primary)

Response

Returns cached mint description summary

Example

curl -X POST "https://api.xona-agent.com/tokens-api/asset-description" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "assetId": "solana",
  "mint": "your_mint_here"
}'

Token Resolve

Resolve a Solana mint address or asset reference to its canonical asset ID and variant details.

POST /tokens-api/resolve

Price

$0.01

Network

Solana

x402

Request parameters

Parameter	Type	Required	Description
`mint`	`string`	No	Solana mint address (base58)
`ref`	`string`	No	Asset reference — assetId, alias, or solana-<mint>. One of mint or ref required.

Response

Returns assetId, asset (name, symbol, category, aliases), and variant (mint, chain, kind, trustTier, tags)

Example

curl -X POST "https://api.xona-agent.com/tokens-api/resolve" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "ref": "usdc or solana-EPjFW..."
}'

Token Risk Summary

Quick risk/quality assessment for a Solana mint — score, grade, label, and trust flags.

POST /tokens-api/risk-summary

Price

$0.01

Network

Solana

x402

Request parameters

Parameter	Type	Required	Description
`mint`	`string`	Yes	Solana mint address

Response

Returns score, grade (A-F), label, tone (info/success/warning/danger), isTrustedLaunch, and hasInsufficientData

Example

curl -X POST "https://api.xona-agent.com/tokens-api/risk-summary" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
}'

Token Search

Search assets by text query — returns canonical assets plus singleton Solana tokens with market stats via Tokens API.

POST /tokens-api/search

Price

$0.01

Network

Solana

x402

Request parameters

Parameter	Type	Required	Description
`q`	`string`	Yes	Search by name, symbol, or mint address
`limit`	`number`	No	Max results 1-50 (default 20)
`category`	`string`	No	Filter by asset category

Response

Returns query, results array with assetId, name, symbol, category, imageUrl, stats (price, liquidity, volume, marketCap, priceChange), and primaryVariant details

Example

curl -X POST "https://api.xona-agent.com/tokens-api/search" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "q": "SOL, USDC, or mint address",
  "limit": "20",
  "category": "your_category_here"
}'

Variant Market

Get the cached market snapshot for a single variant (specific mint) of an asset.

POST /tokens-api/asset-variant-market

Price

$0.01

Network

Solana

x402

Request parameters

Parameter	Type	Required	Description
`assetId`	`string`	Yes	Canonical asset slug or singleton ID
`mint`	`string`	No	Specific variant mint (defaults to primary)

Response

Returns variant market snapshot with price, liquidity, volume, marketCap, and price changes

Example

curl -X POST "https://api.xona-agent.com/tokens-api/asset-variant-market" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "assetId": "usdc",
  "mint": "your_mint_here"
}'

Variant Markets

Batch lookup per-mint variant market snapshots for up to 50 mints.

POST /tokens-api/variant-markets

Price

$0.01

Network

Solana

x402

Request parameters

Parameter	Type	Required	Description
`mints`	`textarea`	Yes	Comma-separated Solana mint addresses (max 50)

Response

Returns variants array with mint, assetId, chain, and market data

Example

curl -X POST "https://api.xona-agent.com/tokens-api/variant-markets" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "mints": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v, So11111111111111111111111111111111111111112"
}'

Price

Network

x402

Price

Network

x402

Price

Network

x402

Price

Network

x402

Price

Network

x402

Price

Network

x402

Price

Network

x402

Price

Network

x402

Price

Network

x402

Price

Network

x402

Price

Network

x402

Price

Network

x402

Price

Network

x402

Price

Network

x402

Price

Network

x402

Price

Network

x402

Price

Network

x402

On this page