# MadeOnSol Batch Token Lookup API

> MadeOnSol Batch Token Lookup API is a paid API for AI agents from api.relai.fi, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Fetches on-chain and DEX metadata for multiple Solana token mints in a single batched round-trip, parallelizing DB, DEX-stream, and RPC supply queries.

## Facts

- Endpoint: GET https://api.relai.fi/relay/1780517153303/token/batch
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/madeonsol-batch-token-lookup-api-41ac5641
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wk9c9kakg0LSfyzEd7rvw

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 madeonsol-batch-token-lookup-api-41ac5641
```

Example prompt: Can you pull up the token metadata for these five Solana mints all at once — So11111111111111111111111111111111111111112, EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v, and three others — using MadeOnSol's batch endpoint so I don't have to call them one by one?

## When to prefer this

Use this endpoint when you need metadata for 2 or more Solana token mints and want to avoid the latency and cost of sequential single-mint calls. It is 10–20× more cost-efficient than calling GET /token/{mint} N times and resolves all mints in parallel. Prefer this over single-mint calls any time you have a list of mints to resolve.

## Known failure modes

- One or more invalid mint addresses returns partial results or per-mint error entries
- Exceeding batch size limit returns a 400 or truncated response
- Mint addresses not found on-chain return null or empty metadata objects
- RPC or DEX-stream timeouts cause partial data for affected mints
- Malformed request returns 400 bad request
- Payment not attached or insufficient USDC triggers 402 payment required

## How this service works

Same per-mint shape as `GET /token/{mint}` but in one round-trip. DB queries batched with `IN (...)`; dex-stream + RPC supply fan-outs run in parallel. 10–20× cheaper than N sequential single-mint calls.

## Output

Returns an array of per-mint token objects (same shape as single-mint GET /token/{mint}) for each requested mint address, including on-chain supply from RPC, DEX stream pricing/liquidity data, and any stored DB metadata — all resolved in one round-trip with parallel fan-outs.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/madeonsol-batch-token-lookup-api-41ac5641/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)