# Agent Data Bench – Token/Pool Search (Solana, Base, Ethereum)

> Agent Data Bench – Token/Pool Search (Solana, Base, Ethereum) is a paid API for AI agents from x402.deepsense.stream, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-28).

Resolves a token symbol, name, or address to DEX pools on Solana, Base, or Ethereum, returning pool metadata sorted by best liquidity first.

## Facts

- Endpoint: GET https://x402.deepsense.stream/api/v1/market/search?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-data-bench-token-pool-search-solana-base-ethereum-c68a2769
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HKPPK_rRL4SjSby2MfNO2

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 agent-data-bench-token-pool-search-solana-base-ethereum-c68a2769
```

Example prompt: Search for DEX pools for the token SOL on Solana and give me the top 3 results with price, liquidity, and market cap — I need a pool address to use for trading.

## When to prefer this

Use this endpoint whenever you need to resolve a token ticker, name, or contract address into a concrete DEX pool address before calling pool detail, OHLCV, trades, or holders endpoints. It is the canonical first step in any DeFi data pipeline on Solana, Base, or Ethereum when the pool address is not already known.

## Known failure modes

- Unknown or misspelled token symbol returns empty results
- Invalid chain enum value returns a 400 validation error
- Token exists but has no DEX pools indexed returns empty list
- Address too long (>64 chars) triggers schema validation failure
- Network timeout or upstream DEX data provider outage returns 5xx

## How this service works

Resolve a token symbol, name or address to DEX pools on Solana, Base or Ethereum: pool, token, dex, price, liquidity, market cap and 24h volume, best liquidity first. Use it to turn a ticker into a tradeable pool address before calling pool, ohlcv, trades or holders.

## Output

A ranked list of DEX pools (up to 20) sorted by liquidity, each containing: pool address, token metadata for both sides, DEX name, current price, total liquidity, market cap, and 24-hour trading volume.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "chain",
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Symbol, name or address (<=64 chars)"
      },
      "chain": {
       "enum": [
        "sol",
        "eth",
        "base"
       ],
       "type": "string",
       "description": "Chain id: sol (Solana), eth (Ethereum), base (Base)"
      },
      "limit": {
       "type": "integer",
       "default": 10,
       "maximum": 20,
       "minimum": 1
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-data-bench-token-pool-search-solana-base-ethereum-c68a2769/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.deepsense.stream](https://www.zero.xyz/host/x402.deepsense.stream/llms.txt)
