Search CoinGecko for coins, exchanges, and categories via pay-per-call MPP endpoint.
What it does
This endpoint exposes CoinGecko's search functionality through the Locus MPP (Micropayment Protocol) gateway. By sending a POST request with a JSON body containing a "query" string, callers can search across CoinGecko's database of coins, exchanges, categories, and NFTs. Each call costs 60,000 base units of pathUSD on Tempo L2, which equals $0.06 per request.
The /coingecko/search endpoint is one of 15 CoinGecko endpoints available through this Locus MPP service. Sibling endpoints cover simple price lookups, token prices by contract address, market charts, coin history, trending coins, exchange rates, global market stats, DeFi stats, top gainers/losers, categories, exchanges, and more — all at the same $0.06/call price point. The service uses the MPP charge intent, meaning each request is a one-shot payment settled via the Tempo method.
Note: The probe returned 404 on HEAD and GET requests, which is expected because this endpoint only accepts POST. The OpenAPI spec confirms POST as the method. No response schema examples are documented, so the exact shape of search results is not specified in the available material, though it presumably mirrors the upstream CoinGecko /search API response.
Capabilities
Use cases
- —Searching for a cryptocurrency by name or symbol to retrieve its CoinGecko ID for further queries
- —Finding exchanges listed on CoinGecko matching a keyword
- —Agent-driven portfolio tools that need to resolve user-typed coin names to canonical identifiers
- —Building chatbots that answer questions about specific cryptocurrencies by first searching for them
Fit
Best for
- —AI agents needing pay-per-call crypto search without API key management
- —Developers who want CoinGecko data settled via micropayments on Tempo L2
- —Programmatic lookups of coin IDs, exchange names, or categories by keyword
Not for
- —High-frequency trading requiring sub-second latency and bulk data
- —Users who need free access — every call costs $0.06
- —Workflows that need response streaming or websocket connections
Quick start
curl -X POST https://coingecko.mpp.paywithlocus.com/coingecko/search \
-H "Content-Type: application/json" \
-d '{"query": "ethereum"}'Example
Request
{
"query": "ethereum"
}Endpoint
Quality
The OpenAPI spec is well-structured with clear request schemas and pricing info for 15 endpoints. However, no response schemas or examples are provided, the probe returned 404 because it used HEAD/GET instead of POST, and crawled pages all returned generic 404 JSON. The endpoint is likely live but unverified via the probe.
Warnings
- —Probe used HEAD/GET but endpoint only accepts POST — liveness not directly confirmed
- —No response schema documented; output shape must be inferred from upstream CoinGecko API
- —Currency address 0x20c000000000000000000000b9537d11c60e8b50 assumed to be pathUSD with 6 decimals based on Tempo convention; if incorrect, price calculation ($0.06) would be wrong
Citations
- —The /coingecko/search endpoint accepts POST with a required 'query' field and costs 60000 base units via Tempohttps://coingecko.mpp.paywithlocus.com
- —15 CoinGecko endpoints are available through this Locus MPP servicehttps://coingecko.mpp.paywithlocus.com
- —API reference docs are at https://docs.coingecko.comhttps://coingecko.mpp.paywithlocus.com
- —LLM-specific docs available at https://beta.paywithlocus.com/mpp/coingecko.mdhttps://coingecko.mpp.paywithlocus.com