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-detailGiá
$0.01
Mạng
Solana
x402
v2
Tham số request
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
assetId | string | Có | Slug tài sản chuẩn (ví dụ "solana", "usdc") hoặc ID singleton ("solana-<mint>") |
include | string | Không | Phân tách bằng dấu phẩy: profile, risk, ohlcv, markets |
mint | string | Không | Mint của biến thể cụ thể dùng cho các phép tính include |
ohlcvInterval | select | Không | Khung 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-profileGiá
$0.01
Mạng
Solana
x402
v2
Tham số request
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
assetId | string | Có | 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-detailsGiá
$0.01
Mạng
Solana
x402
v2
Tham số request
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
assetId | string | Có | Slug tài sản chuẩn hoặc ID singleton |
mint | string | Không | Mint 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-summaryGiá
$0.01
Mạng
Solana
x402
v2
Tham số request
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
assetId | string | Có | Slug tài sản chuẩn hoặc ID singleton |
mint | string | Không | Mint 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-variantsGiá
$0.01
Mạng
Solana
x402
v2
Tham số request
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
assetId | string | Có | Slug tài sản chuẩn hoặc ID singleton |
kind | select | Không | Lọc theo loại biến thể. Một trong: native, wrapped, bridged, lst, stablecoin. |
trustTier | select | Không | Lọ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-snapshotsGiá
$0.01
Mạng
Solana
x402
v2
Tham số request
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
mints | textarea | Có | 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/curatedGiá
$0.01
Mạng
Solana
x402
v2
Tham số request
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
list | string | Không | ID danh sách tuyển chọn hoặc "all" (mặc định: all) |
groupBy | string | Khô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-marketsGiá
$0.01
Mạng
Solana
x402
v2
Tham số request
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
assetId | string | Có | Slug tài sản chuẩn hoặc ID singleton |
mint | string | Không | Mint của biến thể cụ thể (mặc định là biến thể chính) |
offset | number | Không | Offset phân trang (mặc định 0) |
limit | number | Không | Số 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-tickersGiá
$0.01
Mạng
Solana
x402
v2
Tham số request
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
assetId | string | Có | Slug tài sản chuẩn hoặc ID singleton |
offset | number | Không | Offset phân trang (mặc định 0) |
limit | number | Không | Số kết quả mỗi trang 1-50 (mặc định 10) |
order | select | Không | Thứ 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-ohlcvGiá
$0.01
Mạng
Solana
x402
v2
Tham số request
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
assetId | string | Có | Slug tài sản chuẩn hoặc ID singleton |
mint | string | Không | Mint của biến thể cụ thể (mặc định là biến thể chính) |
interval | select | Không | Khung thời gian nến. Một trong: 1m, 5m, 15m, 1H, 4H, 1D, 1W. |
from | number | Không | Unix timestamp bắt đầu (mặc định: 7 ngày trước) |
to | number | Không | Unix 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-chartGiá
$0.01
Mạng
Solana
x402
v2
Tham số request
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
assetId | string | Có | 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-descriptionGiá
$0.01
Mạng
Solana
x402
v2
Tham số request
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
assetId | string | Có | Slug tài sản chuẩn hoặc ID singleton |
mint | string | Không | Mint 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/resolveGiá
$0.01
Mạng
Solana
x402
v2
Tham số request
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
mint | string | Không | Địa chỉ mint Solana (base58) |
ref | string | Không | Tham 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-summaryGiá
$0.01
Mạng
Solana
x402
v2
Tham số request
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
mint | string | Có | Đị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/searchGiá
$0.01
Mạng
Solana
x402
v2
Tham số request
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
q | string | Có | Tìm theo tên, ký hiệu hoặc địa chỉ mint |
limit | number | Không | Số kết quả tối đa 1-50 (mặc định 20) |
category | string | Không | Lọ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-marketGiá
$0.01
Mạng
Solana
x402
v2
Tham số request
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
assetId | string | Có | Slug tài sản chuẩn hoặc ID singleton |
mint | string | Không | Mint 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-marketsGiá
$0.01
Mạng
Solana
x402
v2
Tham số request
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
mints | textarea | Có | 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"
}'