Tokens API
结构化代币数据,包括搜索、解析、市场快照、OHLCV、风险摘要和资产详情。
结构化代币数据,包括搜索、解析、市场快照、OHLCV、风险摘要和资产详情。共 17 个 endpoint,每个都由 x402 支付协议 控制访问,并以 USDC 结算。也可以通过 MCP 服务器 连接相同的 endpoint,用于智能体之间的调用。
资产详情
完整的资产详情、元数据、变体和市场统计。可选包含 profile、risk、OHLCV 或 DEX 市场数据。
POST /tokens-api/asset-detail价格
$0.01
网络
Solana
x402
v2
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
assetId | string | 是 | 规范资产 slug(例如 "solana"、"usdc")或单例 ID("solana-<mint>") |
include | string | 否 | 逗号分隔:profile、risk、ohlcv、markets |
mint | string | 否 | 用于 include 计算的特定变体 mint |
ohlcvInterval | select | 否 | K 线周期(仅在包含 ohlcv 时使用)。可选值:1m、5m、15m、1H、4H、1D、1W。 |
响应
返回完整的资产详情,包含 imageUrl、primaryVariant、stats 以及可选的附加数据(profile、risk、ohlcv、markets)
示例
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"
}'资产概况
获取资产概况、汇总统计、元数据和外部数据提供方的数据。
POST /tokens-api/asset-profile价格
$0.01
网络
Solana
x402
v2
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
assetId | string | 是 | 规范资产 slug 或单例 ID |
响应
返回包含外部市场统计和元数据的资产概况
示例
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"
}'资产风险详情
针对特定资产变体的全面风险分析,包含详细的评分输入。
POST /tokens-api/asset-risk-details价格
$0.01
网络
Solana
x402
v2
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
assetId | string | 是 | 规范资产 slug 或单例 ID |
mint | string | 否 | 特定变体 mint(默认为主变体) |
响应
返回详细的风险分析,包含所有评分输入和明细
示例
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"
}'资产风险摘要
特定资产变体的风险评分摘要,包括评分、等级和信任标记。
POST /tokens-api/asset-risk-summary价格
$0.01
网络
Solana
x402
v2
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
assetId | string | 是 | 规范资产 slug 或单例 ID |
mint | string | 否 | 特定变体 mint(默认为主变体) |
响应
返回风险评分、等级、标签和信任标记
示例
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"
}'资产变体
列出某个规范资产的所有代币变体(原生、封装、跨链桥接等),并提供每个变体的市场数据。
POST /tokens-api/asset-variants价格
$0.01
网络
Solana
x402
v2
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
assetId | string | 是 | 规范资产 slug 或单例 ID |
kind | select | 否 | 按变体类型筛选。可选值:native、wrapped、bridged、lst、stablecoin。 |
trustTier | select | 否 | 按信任等级筛选。可选值:tier1、tier2、experimental。 |
响应
返回资产变体及每个变体的市场快照
示例
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"
}'批量市场快照
一次调用最多批量查询 250 个 Solana mint 的缓存市场快照。
POST /tokens-api/market-snapshots价格
$0.01
网络
Solana
x402
v2
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
mints | textarea | 是 | 逗号分隔的 Solana mint 地址(最多 250 个) |
响应
返回代币行数组,包含元数据和市场快照数据
示例
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"
}'精选资产
获取精选/预先整理的资产集合及其市场数据。
POST /tokens-api/curated价格
$0.01
网络
Solana
x402
v2
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
list | string | 否 | 精选列表 ID 或 "all"(默认:all) |
groupBy | string | 否 | "asset"(默认)或 "mint" |
响应
返回包含市场统计的精选资产列表
示例
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 市场
列出某个资产特定 mint 的 DEX 市场池,包括流动性、交易量和协议代币。
POST /tokens-api/asset-markets价格
$0.01
网络
Solana
x402
v2
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
assetId | string | 是 | 规范资产 slug 或单例 ID |
mint | string | 否 | 特定变体 mint(默认为主变体) |
offset | number | 否 | 分页偏移量(默认 0) |
limit | number | 否 | 每页结果数 1-50(默认 10) |
响应
返回 DEX 市场,包含流动性、交易量和协议代币信息
示例
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"
}'交易所行情
获取资产在各交易所的行情列表,显示其交易场所和交易量。
POST /tokens-api/asset-tickers价格
$0.01
网络
Solana
x402
v2
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
assetId | string | 是 | 规范资产 slug 或单例 ID |
offset | number | 否 | 分页偏移量(默认 0) |
limit | number | 否 | 每页结果数 1-50(默认 10) |
order | select | 否 | 排序方式。可选值:volume_desc。 |
响应
返回包含交易对和交易量的交易所行情数组
示例
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 K 线
获取特定 mint 的 OHLCV(K 线)价格数据,可配置周期和时间范围。
POST /tokens-api/asset-ohlcv价格
$0.01
网络
Solana
x402
v2
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
assetId | string | 是 | 规范资产 slug 或单例 ID |
mint | string | 否 | 特定变体 mint(默认为主变体) |
interval | select | 否 | K 线周期。可选值:1m、5m、15m、1H、4H、1D、1W。 |
from | number | 否 | 开始时间的 Unix 时间戳(默认:7 天前) |
to | number | 否 | 结束时间的 Unix 时间戳(默认:当前) |
响应
返回 assetId、mint、interval 以及 candles 数组(open、high、low、close、volume)
示例
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
}'价格图表
获取资产的规范价格历史图表,优先使用外部数据提供方的数据,不可用时回退到链上 OHLCV。
POST /tokens-api/asset-price-chart价格
$0.01
网络
Solana
x402
v2
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
assetId | string | 是 | 规范资产 slug 或单例 ID |
响应
返回价格图表 K 线数据,包含 assetId、interval、from、to 以及 candles 数组
示例
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"
}'代币描述
获取某个资产特定 mint 的缓存描述摘要。
POST /tokens-api/asset-description价格
$0.01
网络
Solana
x402
v2
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
assetId | string | 是 | 规范资产 slug 或单例 ID |
mint | string | 否 | 特定变体 mint(默认为主变体) |
响应
返回缓存的 mint 描述摘要
示例
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"
}'代币解析
将 Solana mint 地址或资产引用解析为其规范资产 ID 和变体详情。
POST /tokens-api/resolve价格
$0.01
网络
Solana
x402
v2
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
mint | string | 否 | Solana mint 地址(base58) |
ref | string | 否 | 资产引用、assetId、别名或 solana-<mint>。mint 和 ref 必须提供其一。 |
响应
返回 assetId、asset(name、symbol、category、aliases)以及 variant(mint、chain、kind、trustTier、tags)
示例
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..."
}'代币风险摘要
对 Solana mint 进行快速风险/质量评估,包括评分、等级、标签和信任标记。
POST /tokens-api/risk-summary价格
$0.01
网络
Solana
x402
v2
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
mint | string | 是 | Solana mint 地址 |
响应
返回 score、grade(A-F)、label、tone(info/success/warning/danger)、isTrustedLaunch 以及 hasInsufficientData
示例
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"
}'代币搜索
通过文本查询搜索资产,通过 Tokens API 返回规范资产以及单例 Solana 代币及其市场统计。
POST /tokens-api/search价格
$0.01
网络
Solana
x402
v2
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
q | string | 是 | 按名称、符号或 mint 地址搜索 |
limit | number | 否 | 最大结果数 1-50(默认 20) |
category | string | 否 | 按资产类别筛选 |
响应
返回 query,以及包含 assetId、name、symbol、category、imageUrl、stats(price、liquidity、volume、marketCap、priceChange)和 primaryVariant 详情的 results 数组
示例
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"
}'变体市场
获取资产单个变体(特定 mint)的缓存市场快照。
POST /tokens-api/asset-variant-market价格
$0.01
网络
Solana
x402
v2
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
assetId | string | 是 | 规范资产 slug 或单例 ID |
mint | string | 否 | 特定变体 mint(默认为主变体) |
响应
返回变体市场快照,包含价格、流动性、交易量、marketCap 和价格变化
示例
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"
}'批量变体市场
批量查询最多 50 个 mint 的变体市场快照。
POST /tokens-api/variant-markets价格
$0.01
网络
Solana
x402
v2
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
mints | textarea | 是 | 逗号分隔的 Solana mint 地址(最多 50 个) |
响应
返回 variants 数组,包含 mint、assetId、chain 和市场数据
示例
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"
}'