# Einstein AI x402 API – Top Volume Tokens

> Einstein AI x402 API – Top Volume Tokens is a paid API for AI agents from api.relai.fi, paid per call via x402, $0.550000/call, status unknown (last checked 2026-09-13).

Returns the tokens with the highest trading volume on a specified blockchain over a chosen time period.

## Facts

- Endpoint: POST https://api.relai.fi/relay/1769629274857/x402/bitquery/topvolume
- Price: $0.550000/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/einstein-ai-x402-api-top-volume-tokens-40bdfcb8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9XrEmWfy-9X93fieD2Nhr

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 einstein-ai-x402-api-top-volume-tokens-40bdfcb8 -d '<json body>'
```

Example prompt: Show me the top 20 tokens by trading volume on Ethereum over the last 24 hours.

## When to prefer this

Use this endpoint when you need a ranked list of tokens by trading volume across major EVM-compatible chains or Solana, especially when you want flexible time windows (1h to 30d) and chain selection. Prefer this over generic DEX screeners when you need programmatic, pay-per-call access without API key setup.

## Known failure modes

- Unsupported chain value returns validation error
- Invalid time period enum returns error
- limit exceeding 500 may be rejected or clamped
- BitQuery upstream timeout or rate limit causes 5xx error
- Payment of $0.55 USDC not fulfilled causes 402 response

## How this service works

Analyze tokens with highest trading volume in specified time period. Supported chains: base, ethereum, bsc, arbitrum, polygon, optimism, zksync, solana. Default chain: base. Required params: none (chain/limit/timeperiod are optional and defaulted).

## Output

A ranked list of tokens with the highest trading volume on the specified blockchain for the given time period, including token identifiers and volume metrics. Defaults to Base chain, top 10 results, over a default time window if no parameters are provided.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "base",
    "ethereum",
    "bsc",
    "arbitrum",
    "polygon",
    "optimism",
    "solana"
   ],
   "type": "string",
   "description": "Blockchain to query (e.g., base, ethereum, bsc, solana)"
  },
  "limit": {
   "type": "string",
   "description": "Maximum number of results to return (default: 10, max: 500)"
  },
  "timeperiod": {
   "enum": [
    "1h",
    "4h",
    "24h",
    "7d",
    "30d"
   ],
   "type": "string",
   "description": "Time period for analysis (e.g., 1h, 24h, 7d, 30d)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/einstein-ai-x402-api-top-volume-tokens-40bdfcb8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.relai.fi](https://www.zero.xyz/host/api.relai.fi/llms.txt)