Token Intelligence

On-chain market intelligence — Pump.fun trends, Solana/X Layer discovery, token signals and starter kits. 9 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.

PumpFun Movers

Get movers PumpFun tokens with AI-powered analysis including dominant meta summary, fresh token suggestions, and detailed token information with price changes and icon descriptions.

GET /token/pumpfun-movers

Request parameters

This endpoint takes no body parameters.

Response

Returns summary (dominant meta analysis), suggestions (3 fresh token ideas), trending_tokens (array with icon, name, ticker, mc, ca, social links, price changes, icon_description), and count

Example

curl "https://api.xona-agent.com/token/pumpfun-movers" \
  -H "X-PAYMENT: <x402-payment-payload>"

PumpFun Trending

Get trending PumpFun tokens with AI-powered analysis including dominant meta summary, fresh token suggestions, and detailed token information with price changes and icon descriptions.

GET /token/pumpfun-trending

Request parameters

This endpoint takes no body parameters.

Response

Returns summary (dominant meta analysis), suggestions (3 fresh token ideas), trending_tokens (array with icon, name, ticker, mc, ca, social links, price changes, icon_description), and count

Example

curl "https://api.xona-agent.com/token/pumpfun-trending" \
  -H "X-PAYMENT: <x402-payment-payload>"

Solana Discovery

Discover trending tokens on Solana via OKX Onchain OS — hot tokens, top movers, smart money signals, and top traders. Multi-chain market intelligence powered by 500+ DEXs.

POST /token/solana-discovery

Request parameters

Response

Returns chain, action, and data array with token details (price, volume, market cap, holders, etc.)

Example

curl -X POST "https://api.xona-agent.com/token/solana-discovery" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "action": "hot_tokens",
  "keyword": "e.g., SOL, BONK",
  "limit": 20
}'

Solana Market

Deep token analysis on Solana via OKX Onchain OS — price overview, holder analysis, candlesticks, and whale trades.

POST /token/solana-market

Request parameters

Response

Returns chain, action, and data with token analysis details (price, risk score, holders, candles, trades, etc.)

Example

curl -X POST "https://api.xona-agent.com/token/solana-market" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "action": "token_overview",
  "tokenAddress": "Token mint address",
  "bar": "1H"
}'

Token News

Fetch token information from Jupiter via Corbits, get curated news from Syra, and generate banner and social content with Xona.

POST /token/news

Request parameters

Response

Returns mint, token name, ticker, and trending_news with title, tweet_draft, and banner_url

Example

curl -X POST "https://api.xona-agent.com/token/news" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "token": "SOL or So11111111111111111111111111111111111111112"
}'

Token Signal

AI-powered market sentiment analysis for any crypto ticker. Returns sentiment score, 7-day price target, top 3 market signals, risk level, and a one-sentence agent-ready summary.

POST /token/signal

Request parameters

Response

Returns sentiment, sentiment_score (-1 to 1), current price, 7-day price target, top 3 signals, risk level, summary, and catalyst

Example

curl -X POST "https://api.xona-agent.com/token/signal" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "ticker": "SOL"
}'

Token Starter Kit

Generate token logo and banner automatically from a prompt. Extracts token information, generates logo, then creates a matching banner. Optionally uses a reference token CA to extract logo style.

POST /token/starter-kit

Request parameters

Response

Returns token_name, token_ticker, token_description, logo_url, and banner_url

Example

curl -X POST "https://api.xona-agent.com/token/starter-kit" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "prompt": "A meme token about a samurai warrior with AI powers, combining traditional Japanese aesthetics with modern technology",
  "ca_reference": "Token contract address"
}'

X Layer Discovery

Discover trending tokens on X Layer via OKX Onchain OS — hot tokens, top movers, and token search. Powered by Onchain OS with zero gas fees.

POST /token/xlayer-discovery

Request parameters

Response

Returns chain, action, and data array with X Layer token details (price, volume, market cap, holders, etc.)

Example

curl -X POST "https://api.xona-agent.com/token/xlayer-discovery" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "action": "hot_tokens",
  "keyword": "e.g., OKB, WOKB",
  "limit": 20
}'

X Layer Market

Deep token analysis on X Layer via OKX Onchain OS — price overview, holder analysis, candlesticks, and whale trades.

POST /token/xlayer-market

Request parameters

Response

Returns chain, action, and data with X Layer token analysis details (price, risk score, holders, candles, trades, etc.)

Example

curl -X POST "https://api.xona-agent.com/token/xlayer-market" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "action": "token_overview",
  "tokenAddress": "0x...",
  "bar": "1H"
}'