# Allium Token Search

> Allium Token Search is a paid API for AI agents from Allium at agents.allium.so, paid per call via MPP, $0.03/call, status unknown (last checked 2026-10-13).

Search for blockchain tokens by name or symbol across supported chains

## Facts

- Endpoint: GET https://agents.allium.so/api/v1/developer/tokens/search?utm_source=zero.xyz
- Price: $0.03/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Provider: Allium
- Docs: https://docs.allium.so
- Website: https://allium.so
- Tags: blockchain, prices, tokens, wallet, balances, transactions, pnl, sql, explorer, solana, base, defi, data
- Canonical page: https://www.zero.xyz/c/allium-search-eda11ae6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5d6uapOtti3skbt318C2_

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 allium-search-eda11ae6
```

Example prompt: Search Allium for tokens matching the symbol 'USDC' so I can see which chains it's supported on and get its contract address.

## When to prefer this

Use this endpoint when you need to discover token metadata (contract address, chain, symbol) by searching with a partial name or ticker symbol. Prefer this over the Chain Address endpoint when you don't already know the contract address, or over the Tokens list endpoint when you want filtered results rather than the full token catalog.

## Known failure modes

- No tokens found matching query — returns empty result set
- Invalid or missing search parameter — returns 400 error
- Authentication failure — returns 401 or 402 payment required
- Rate limit exceeded — returns 429 error
- Search query too short or malformed — returns validation error

## How this service works

Search tokens by name or symbol

## Output

A list of matching token records including token name, symbol, contract address, chain, and other metadata for tokens matching the search query.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/allium-search-eda11ae6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.allium.so](https://www.zero.xyz/host/agents.allium.so/llms.txt)