# MadeOnSol Token Browse API

> MadeOnSol Token Browse 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).

Browse and filter Solana tokens by market-cap band, liquidity floor, DEX, volume, MEV-share, authority/safety flags, and recent MC change

## Facts

- Endpoint: GET https://api.relai.fi/relay/1780517153303/tokens
- 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-token-browse-api-20151944
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-1ea59gl13GThOI_vCn85

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-token-browse-api-20151944
```

Example prompt: Show me Solana tokens with at least $5000 liquidity, a market cap between $100k and $10M, and at least 5% MC gain in the last hour — only ones trading on Raydium and with no mint authority.

## When to prefer this

Use this endpoint when you need to browse or screen a list of Solana tokens across multiple filter dimensions (MC band, liquidity, volume, DEX, safety flags, MEV share) rather than looking up a single known token. Prefer this over /token/{mint} when you don't have a specific mint address and are doing discovery or screening. Choose this over KOL-scoped endpoints when you want market-wide token discovery not limited to influencer-tracked tokens.

## Known failure modes

- Computed filters (volume, MEV-share, MC change) may return fewer results than the requested limit — detectable via pagination.post_filtered: true
- Passing min_liq=0 may return many low-quality phantom-MC tokens from thin pools
- Invalid or out-of-range filter parameters return error responses
- Payment not included or insufficient USDC results in 402 response
- No tokens match the combined filters, returning an empty result set

## How this service works

Browse tokens by market-cap band, liquidity floor, recent-activity window, primary DEX, authority/safety flags, computed 1h volume, MEV-share ceiling, and MC change. Complements `/token/{mint}` (single lookup) and the KOL-scoped `/kol/tokens/{hot,trending}`.

**Default `min_liq` is 2000 USD** to filter the long tail of phantom-MC tokens from low-liquidity pools. Pass `min_liq=0` to opt out.

**Computed filters** (`min_volume_1h_usd`, `max_mev_share_pct`, `mc_change_1h_min_pct`, `mc_change_1h_max_pct`) over-fetch 3× from the DB and filter in JS — pagination page size may be smaller than `limit` when set. The response includes `pagination.post_filtered: true` so clients can detect this.

## Output

A paginated list of Solana tokens matching the specified filters, each with market cap, liquidity, 1h volume, MEV-share percentage, MC change, DEX, and authority/safety flags. The pagination object includes a post_filtered flag indicating whether computed filters reduced the page size below the requested limit.

## More

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