Tokens API

Dữ liệu token có cấu trúc, bao gồm tìm kiếm, phân giải, snapshot thị trường, OHLCV, tóm tắt rủi ro và chi tiết tài sản.

Dữ liệu token có cấu trúc, bao gồm tìm kiếm, phân giải, snapshot thị trường, OHLCV, tóm tắt rủi ro và chi tiết tài sản. Gồm 17 endpoint, mỗi endpoint được bảo vệ bằng giao thức thanh toán x402 và thanh toán bằng USDC. Bạn cũng có thể kết nối các endpoint này qua MCP server để dùng giữa các agent.

Chi tiết tài sản

Chi tiết đầy đủ về tài sản, metadata, các biến thể và thống kê thị trường. Có thể kèm thêm profile, rủi ro, OHLCV hoặc thị trường DEX.

POST /tokens-api/asset-detail

Giá

$0.01

Mạng

Solana

x402

v2

Tham số request

Tham sốKiểuBắt buộcMô tả
assetIdstringCóSlug tài sản chuẩn (ví dụ "solana", "usdc") hoặc ID singleton ("solana-<mint>")
includestringKhôngPhân tách bằng dấu phẩy: profile, risk, ohlcv, markets
mintstringKhôngMint của biến thể cụ thể dùng cho các phép tính include
ohlcvIntervalselectKhôngKhung thời gian nến (chỉ khi include ohlcv). Một trong: 1m, 5m, 15m, 1H, 4H, 1D, 1W.

Response

Trả về chi tiết tài sản đầy đủ với imageUrl, primaryVariant, stats và các phần include tùy chọn (profile, risk, ohlcv, markets)

Ví dụ

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"
}'

Hồ sơ tài sản

Lấy hồ sơ tài sản, thống kê tổng hợp, metadata và dữ liệu từ nhà cung cấp bên ngoài.

POST /tokens-api/asset-profile

Giá

$0.01

Mạng

Solana

x402

v2

Tham số request

Tham sốKiểuBắt buộcMô tả
assetIdstringCóSlug tài sản chuẩn hoặc ID singleton

Response

Trả về hồ sơ tài sản cùng thống kê thị trường bên ngoài và metadata

Ví dụ

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"
}'

Chi tiết rủi ro tài sản

Phân tích rủi ro toàn diện với các đầu vào chấm điểm chi tiết cho một biến thể tài sản cụ thể.

POST /tokens-api/asset-risk-details

Giá

$0.01

Mạng

Solana

x402

v2

Tham số request

Tham sốKiểuBắt buộcMô tả
assetIdstringCóSlug tài sản chuẩn hoặc ID singleton
mintstringKhôngMint của biến thể cụ thể (mặc định là biến thể chính)

Response

Trả về phân tích rủi ro chi tiết với tất cả đầu vào chấm điểm và bảng phân tích

Ví dụ

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"
}'

Tóm tắt rủi ro tài sản

Tóm tắt điểm rủi ro cho một biến thể tài sản cụ thể: điểm số, xếp hạng và các cờ tin cậy.

POST /tokens-api/asset-risk-summary

Giá

$0.01

Mạng

Solana

x402

v2

Tham số request

Tham sốKiểuBắt buộcMô tả
assetIdstringCóSlug tài sản chuẩn hoặc ID singleton
mintstringKhôngMint của biến thể cụ thể (mặc định là biến thể chính)

Response

Trả về điểm rủi ro, xếp hạng, nhãn và các cờ tin cậy

Ví dụ

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"
}'

Biến thể tài sản

Liệt kê tất cả biến thể token (native, wrapped, bridged, v.v.) của một tài sản chuẩn, kèm dữ liệu thị trường cho từng biến thể.

POST /tokens-api/asset-variants

Giá

$0.01

Mạng

Solana

x402

v2

Tham số request

Tham sốKiểuBắt buộcMô tả
assetIdstringCóSlug tài sản chuẩn hoặc ID singleton
kindselectKhôngLọc theo loại biến thể. Một trong: native, wrapped, bridged, lst, stablecoin.
trustTierselectKhôngLọc theo cấp độ tin cậy. Một trong: tier1, tier2, experimental.

Response

Trả về các biến thể tài sản kèm snapshot thị trường của từng biến thể

Ví dụ

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"
}'

Snapshot thị trường hàng loạt

Tra cứu hàng loạt snapshot thị trường đã cache cho tối đa 250 mint Solana trong một lần gọi.

POST /tokens-api/market-snapshots

Giá

$0.01

Mạng

Solana

x402

v2

Tham số request

Tham sốKiểuBắt buộcMô tả
mintstextareaCóCác địa chỉ mint Solana phân tách bằng dấu phẩy (tối đa 250)

Response

Trả về mảng các dòng token với metadata và dữ liệu snapshot thị trường

Ví dụ

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"
}'

Tài sản tuyển chọn

Lấy các bộ sưu tập tài sản được tuyển chọn/tổng hợp sẵn kèm dữ liệu thị trường.

POST /tokens-api/curated

Giá

$0.01

Mạng

Solana

x402

v2

Tham số request

Tham sốKiểuBắt buộcMô tả
liststringKhôngID danh sách tuyển chọn hoặc "all" (mặc định: all)
groupBystringKhông"asset" (mặc định) hoặc "mint"

Response

Trả về danh sách tài sản tuyển chọn kèm thống kê thị trường

Ví dụ

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"
}'

Thị trường DEX

Liệt kê các pool thị trường DEX cho một mint cụ thể của tài sản: thanh khoản, khối lượng và token của giao thức.

POST /tokens-api/asset-markets

Giá

$0.01

Mạng

Solana

x402

v2

Tham số request

Tham sốKiểuBắt buộcMô tả
assetIdstringCóSlug tài sản chuẩn hoặc ID singleton
mintstringKhôngMint của biến thể cụ thể (mặc định là biến thể chính)
offsetnumberKhôngOffset phân trang (mặc định 0)
limitnumberKhôngSố kết quả mỗi trang 1-50 (mặc định 10)

Response

Trả về các thị trường DEX với thông tin thanh khoản, khối lượng và token của giao thức

Ví dụ

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"
}'

Ticker sàn giao dịch

Lấy danh sách ticker trên các sàn giao dịch của một tài sản, cho biết tài sản được giao dịch ở đâu và với khối lượng bao nhiêu.

POST /tokens-api/asset-tickers

Giá

$0.01

Mạng

Solana

x402

v2

Tham số request

Tham sốKiểuBắt buộcMô tả
assetIdstringCóSlug tài sản chuẩn hoặc ID singleton
offsetnumberKhôngOffset phân trang (mặc định 0)
limitnumberKhôngSố kết quả mỗi trang 1-50 (mặc định 10)
orderselectKhôngThứ tự sắp xếp. Một trong: volume_desc.

Response

Trả về mảng ticker sàn giao dịch với các cặp giao dịch và khối lượng

Ví dụ

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"
}'

Nến OHLCV

Lấy dữ liệu giá OHLCV (nến) cho một mint cụ thể, có thể cấu hình khung thời gian và khoảng thời gian.

POST /tokens-api/asset-ohlcv

Giá

$0.01

Mạng

Solana

x402

v2

Tham số request

Tham sốKiểuBắt buộcMô tả
assetIdstringCóSlug tài sản chuẩn hoặc ID singleton
mintstringKhôngMint của biến thể cụ thể (mặc định là biến thể chính)
intervalselectKhôngKhung thời gian nến. Một trong: 1m, 5m, 15m, 1H, 4H, 1D, 1W.
fromnumberKhôngUnix timestamp bắt đầu (mặc định: 7 ngày trước)
tonumberKhôngUnix timestamp kết thúc (mặc định: hiện tại)

Response

Trả về assetId, mint, interval và mảng candles (open, high, low, close, volume)

Ví dụ

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
}'

Biểu đồ giá

Lấy biểu đồ lịch sử giá chuẩn của một tài sản, dùng dữ liệu từ nhà cung cấp bên ngoài khi có, nếu không sẽ chuyển sang OHLCV on-chain.

POST /tokens-api/asset-price-chart

Giá

$0.01

Mạng

Solana

x402

v2

Tham số request

Tham sốKiểuBắt buộcMô tả
assetIdstringCóSlug tài sản chuẩn hoặc ID singleton

Response

Trả về dữ liệu nến của biểu đồ giá với assetId, interval, from, to và mảng candles

Ví dụ

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"
}'

Mô tả token

Lấy bản tóm tắt mô tả đã cache cho một mint cụ thể của tài sản.

POST /tokens-api/asset-description

Giá

$0.01

Mạng

Solana

x402

v2

Tham số request

Tham sốKiểuBắt buộcMô tả
assetIdstringCóSlug tài sản chuẩn hoặc ID singleton
mintstringKhôngMint của biến thể cụ thể (mặc định là biến thể chính)

Response

Trả về bản tóm tắt mô tả mint đã cache

Ví dụ

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"
}'

Phân giải token

Phân giải một địa chỉ mint Solana hoặc tham chiếu tài sản thành ID tài sản chuẩn và chi tiết biến thể của nó.

POST /tokens-api/resolve

Giá

$0.01

Mạng

Solana

x402

v2

Tham số request

Tham sốKiểuBắt buộcMô tả
mintstringKhôngĐịa chỉ mint Solana (base58)
refstringKhôngTham chiếu tài sản, assetId, alias hoặc solana-<mint>. Bắt buộc có một trong mint hoặc ref.

Response

Trả về assetId, asset (name, symbol, category, aliases) và variant (mint, chain, kind, trustTier, tags)

Ví dụ

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..."
}'

Tóm tắt rủi ro token

Đánh giá nhanh rủi ro/chất lượng cho một mint Solana: điểm số, xếp hạng, nhãn và các cờ tin cậy.

POST /tokens-api/risk-summary

Giá

$0.01

Mạng

Solana

x402

v2

Tham số request

Tham sốKiểuBắt buộcMô tả
mintstringCóĐịa chỉ mint Solana

Response

Trả về score, grade (A-F), label, tone (info/success/warning/danger), isTrustedLaunch và hasInsufficientData

Ví dụ

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"
}'

Tìm kiếm token

Tìm kiếm tài sản bằng truy vấn văn bản, trả về các tài sản chuẩn cùng các token Solana singleton kèm thống kê thị trường qua Tokens API.

POST /tokens-api/search

Giá

$0.01

Mạng

Solana

x402

v2

Tham số request

Tham sốKiểuBắt buộcMô tả
qstringCóTìm theo tên, ký hiệu hoặc địa chỉ mint
limitnumberKhôngSố kết quả tối đa 1-50 (mặc định 20)
categorystringKhôngLọc theo danh mục tài sản

Response

Trả về query, mảng results với assetId, name, symbol, category, imageUrl, stats (price, liquidity, volume, marketCap, priceChange) và chi tiết primaryVariant

Ví dụ

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"
}'

Thị trường biến thể

Lấy snapshot thị trường đã cache cho một biến thể đơn lẻ (mint cụ thể) của tài sản.

POST /tokens-api/asset-variant-market

Giá

$0.01

Mạng

Solana

x402

v2

Tham số request

Tham sốKiểuBắt buộcMô tả
assetIdstringCóSlug tài sản chuẩn hoặc ID singleton
mintstringKhôngMint của biến thể cụ thể (mặc định là biến thể chính)

Response

Trả về snapshot thị trường của biến thể với giá, thanh khoản, khối lượng, marketCap và biến động giá

Ví dụ

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"
}'

Thị trường nhiều biến thể

Tra cứu hàng loạt snapshot thị trường theo từng mint biến thể cho tối đa 50 mint.

POST /tokens-api/variant-markets

Giá

$0.01

Mạng

Solana

x402

v2

Tham số request

Tham sốKiểuBắt buộcMô tả
mintstextareaCóCác địa chỉ mint Solana phân tách bằng dấu phẩy (tối đa 50)

Response

Trả về mảng variants với mint, assetId, chain và dữ liệu thị trường

Ví dụ

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"
}'

Trên trang này