Search tokens by name or symbol across 150+ blockchains via Allium's onchain data API.
What it does
This endpoint lets AI agents search for tokens by name or symbol, returning structured data including chain, contract address, token type, current price, decimals, and liquidity/volume attributes. It is part of Allium's AgentHub platform, which provides enterprise-grade blockchain data covering 150+ chains (EVM, Solana, Bitcoin, and more). Allium's data infrastructure powers products at Phantom, Uniswap, Coinbase, and other teams operating at scale.
The endpoint is live and uses the MPP (Machine Payment Protocol) with both Tempo (pathUSD on chain 4217) and x402 (USDC on Base and Solana) settlement options. Each request costs 30,000 base units of USDC (6 decimals), which equals $0.03 per call. Payment can also be made via a traditional API key. The response is JSON and returns an array of token objects, each containing the chain name, contract address, token type, price, decimals, name/symbol info, and market attributes like total liquidity and 24-hour volume.
No OpenAPI schema or detailed query-parameter documentation was found in the crawl. The endpoint accepts HTTP GET requests, and query parameters for specifying the search term (e.g., token name or symbol) are not documented in the available material. The example output from the Bazaar extension shows a representative token object structure but does not clarify the full request interface.
Capabilities
Use cases
- —Agent-driven token discovery by name or ticker symbol across 150+ chains
- —Retrieving real-time token prices and liquidity metrics for portfolio analysis
- —Resolving token contract addresses from human-readable names for downstream DeFi operations
- —Building conversational crypto assistants that answer questions about specific tokens
- —Automated market screening by querying token volume and liquidity attributes
Fit
Best for
- —AI agents needing programmatic access to multi-chain token metadata and prices
- —Developers building crypto-aware chatbots or copilots
- —Automated workflows that resolve token symbols to contract addresses and prices
Not for
- —Historical OHLCV candlestick charting (endpoint returns search results, not time-series)
- —Non-crypto use cases with no need for blockchain token data
- —Bulk data export of all tokens across all chains (this is a search endpoint, not a dump)
Quick start
curl -X GET "https://agents.allium.so/api/v1/developer/tokens/search?q=WETH" \
-H "Authorization: Bearer <YOUR_API_KEY_OR_X402_TOKEN>"Example
Response
[
{
"info": {
"name": "Wrapped Ether",
"symbol": "WETH"
},
"type": "evm_erc20",
"chain": "ethereum",
"price": 2500.5,
"object": "token",
"address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
"decimals": 18,
"attributes": {
"volume_usd_1d": 850000000,
"total_liquidity_usd": {
"amount": 1500000000
}
}
}
]Endpoint
Quality
The endpoint is live with a valid 402 MPP challenge and includes a Bazaar output example, but no OpenAPI spec, no query-parameter documentation, and no detailed docs were found. Pricing is clear ($0.03/call in USDC). Key request interface details are inferred.
Warnings
- —No OpenAPI or formal schema documentation available; query parameters are inferred from the endpoint path and description.
- —The /docs path on agents.allium.so returns 404; detailed API documentation is not publicly accessible at the crawled URLs.
- —The currency address in the Tempo challenge (0x20c0...8b50) does not match a well-known USDC contract; assumed 6 decimals based on the x402 body which explicitly names USDC with amount 30000.
- —The example request snippet infers a 'q' query parameter which is not explicitly documented.
Citations
- —Allium covers 150+ chains including EVM, Solana, and Bitcoinhttps://agents.allium.so
- —Allium's data infrastructure powers Phantom, Uniswap, Coinbase, and other teamshttps://agents.allium.so
- —AgentHub supports x402 with USDC on Base and also supports traditional API keyshttps://agents.allium.so
- —The endpoint costs 30000 base units of USDC per request (x402 body)https://agents.allium.so/api/v1/developer/tokens/search
- —The example token response includes chain, address, type, price, decimals, info, and attributes fieldshttps://agents.allium.so/api/v1/developer/tokens/search