{"uid":"cap_7I2dzMAoGbrR_-C8PFE5_","slug":"allium-4c93d688","name":"Allium Token Search","description":"Search tokens by name or symbol","url":"https://agents.allium.so/api/v1/developer/tokens/search","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":[{"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}}}]},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.03","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MSNEgpcqH0Ree7Ekmuekq","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_0prxFdpa_XsxCmzg-A0IN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search for blockchain tokens by name or symbol to retrieve token metadata and identifiers","exampleAgentPrompt":"Search Allium for tokens matching the symbol 'USDC' so I can get the token ID and chain details before checking its price.","exampleUseCases":null,"resultDescription":"A list of tokens matching the search query, including token names, symbols, identifiers, and associated blockchain network metadata that can be used in subsequent Allium API calls for prices or balances.","failureModes":["No tokens found matching the search term — returns empty result set","Ambiguous or very common symbol returns large number of results requiring further filtering","Invalid or missing query parameter returns 400 error","Payment not processed or insufficient funds returns 402 error","Rate limiting or service unavailability returns 429 or 503 error"],"whenToPreferThis":"Use this endpoint when you need to resolve a human-readable token name or ticker symbol into structured token metadata (IDs, chain info) before calling other Allium endpoints like price lookup or balance checks. Prefer this over the full token list endpoint when you have a specific token in mind and want a targeted search result rather than paginating through all supported tokens.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:31:03.487Z","isFirstParty":false}