# Agent402 Solana Token Search

> Agent402 Solana Token Search is a paid API for AI agents from agent402.tools, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Search Solana token pairs by name, ticker, or contract address and return live market data including price, volume, liquidity, and transaction counts from DexScreener.

## Facts

- Endpoint: POST https://agent402.tools/api/sol-token-search
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-solana-token-search-cd111c6d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6-CE61FeIY-ZGgc2E-X79

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agent402-solana-token-search-cd111c6d -d '<json body>'
```

Example prompt: Search for the top 5 Solana trading pairs for 'JUP' and show me the current price, 24h volume, liquidity, and which DEX each pair is on.

## When to prefer this

Use this endpoint when you need live Solana token market data by name, ticker, or contract address — especially when you want DEX-specific data (liquidity, transaction counts, pair age) rather than just a price. Prefer this over generic crypto price APIs when the user is specifically researching Solana DeFi tokens, memecoins, or newly listed pairs on DEXes like Meteora or Raydium.

## Known failure modes

- Query string too long (>80 chars) returns validation error
- Limit out of range (0 or >30) returns validation error
- Unknown or misspelled token name returns empty pairs array
- Token with no Solana DEX pairs returns empty results
- DexScreener API unavailable returns upstream error
- Payment failure (insufficient USDC) blocks the call

## How this service works

Find Solana tokens and pairs by name, ticker or address across every DEX DexScreener indexes, filtered to Solana only, in DexScreener relevance order: base and quote token, mint addresses, DEX, price, liquidity, 24h volume and change, transaction counts, pair age and whether the token has a filled-in profile (ticker impostors usually do not). Resolve a ticker to a mint before calling sol-token-safety or sol-swap-quote. Keyless.

## Output

Returns a ranked list of Solana token trading pairs matching the query, each with DEX name, base/quote token details (name, symbol, address), pair address, price in USD and native SOL, market cap, FDV, liquidity in USD, volume over multiple timeframes (5m, 1h, 6h, 24h), buy/sell transaction counts, price change percentages, pair age in hours, labels (e.g. DLMM), and a DexScreener URL. Results follow DexScreener relevance ordering.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "number",
   "description": "Pairs to return (1-30, default 10)."
  },
  "query": {
   "type": "string",
   "description": "Token name, ticker, or address (1-80 chars)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Rows keep DexScreener relevance order.",
  "pairs": [
   {
    "dex": "meteora",
    "fdv": 1395785031,
    "url": "https://dexscreener.com/solana/eoft...",
    "base": {
     "name": "Jupiter",
     "symbol": "JUP",
     "address": "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN"
    },
    "quote": {
     "symbol": "SOL",
     "address": "So11111111111111111111111111111111111111112"
    },
    "labels": [
     "DLMM"
    ],
    "txns1h": {
     "buys": 30,
     "sells": 28
    },
    "volume": {
     "h1": 20000,
     "h6": 100000,
     "m5": 1000,
     "h24": 500000
    },
    "txns24h": {
     "buys": 900,
     "sells": 850
    },
    "ageHours": 14000,
    "priceUsd": 0.2034,
    "marketCap": 675335464,
    "hasProfile": true,
    "pairAddress": "EoFt...",
    "priceNative": 0.00217,
    "liquidityUsd": 1260729.15,
    "pairCreatedAt": "2025-01-01T00:00:00.000Z",
    "priceChangePct": {
     "h1": -0.3,
     "h6": 0.2,
     "m5": 0,
     "h24": -2.4
    }
   }
  ],
  "query": "JUP",
  "source": "dexscreener",
  "fetchedAt": "2026-08-22T12:00:00.000Z",
  "totalSolanaPairs": 28
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-solana-token-search-cd111c6d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)