Tokens API

结构化代币数据,包括搜索、解析、市场快照、OHLCV、风险摘要和资产详情。

结构化代币数据,包括搜索、解析、市场快照、OHLCV、风险摘要和资产详情。共 17 个 endpoint,每个都由 x402 支付协议 控制访问,并以 USDC 结算。也可以通过 MCP 服务器 连接相同的 endpoint,用于智能体之间的调用。

资产详情

完整的资产详情、元数据、变体和市场统计。可选包含 profile、risk、OHLCV 或 DEX 市场数据。

POST /tokens-api/asset-detail

价格

$0.01

网络

Solana

x402

v2

请求参数

参数类型必填说明
assetIdstring是规范资产 slug(例如 "solana"、"usdc")或单例 ID("solana-<mint>")
includestring否逗号分隔:profile、risk、ohlcv、markets
mintstring否用于 include 计算的特定变体 mint
ohlcvIntervalselect否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

请求参数

参数类型必填说明
assetIdstring是规范资产 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

请求参数

参数类型必填说明
assetIdstring是规范资产 slug 或单例 ID
mintstring否特定变体 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

请求参数

参数类型必填说明
assetIdstring是规范资产 slug 或单例 ID
mintstring否特定变体 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

请求参数

参数类型必填说明
assetIdstring是规范资产 slug 或单例 ID
kindselect否按变体类型筛选。可选值:native、wrapped、bridged、lst、stablecoin。
trustTierselect否按信任等级筛选。可选值: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

请求参数

参数类型必填说明
mintstextarea是逗号分隔的 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

请求参数

参数类型必填说明
liststring否精选列表 ID 或 "all"(默认:all)
groupBystring否"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

请求参数

参数类型必填说明
assetIdstring是规范资产 slug 或单例 ID
mintstring否特定变体 mint(默认为主变体)
offsetnumber否分页偏移量(默认 0)
limitnumber否每页结果数 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

请求参数

参数类型必填说明
assetIdstring是规范资产 slug 或单例 ID
offsetnumber否分页偏移量(默认 0)
limitnumber否每页结果数 1-50(默认 10)
orderselect否排序方式。可选值: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

请求参数

参数类型必填说明
assetIdstring是规范资产 slug 或单例 ID
mintstring否特定变体 mint(默认为主变体)
intervalselect否K 线周期。可选值:1m、5m、15m、1H、4H、1D、1W。
fromnumber否开始时间的 Unix 时间戳(默认:7 天前)
tonumber否结束时间的 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

请求参数

参数类型必填说明
assetIdstring是规范资产 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

请求参数

参数类型必填说明
assetIdstring是规范资产 slug 或单例 ID
mintstring否特定变体 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

请求参数

参数类型必填说明
mintstring否Solana mint 地址(base58)
refstring否资产引用、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

请求参数

参数类型必填说明
mintstring是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

请求参数

参数类型必填说明
qstring是按名称、符号或 mint 地址搜索
limitnumber否最大结果数 1-50(默认 20)
categorystring否按资产类别筛选

响应

返回 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

请求参数

参数类型必填说明
assetIdstring是规范资产 slug 或单例 ID
mintstring否特定变体 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

请求参数

参数类型必填说明
mintstextarea是逗号分隔的 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"
}'

本页目录