Look up token prices by contract address via CoinGecko data, paid per-call on Tempo L2.
What it does
This MPP endpoint provides token price lookups by contract address, powered by CoinGecko market data and served through the Locus MPP gateway. You supply a platform ID (e.g. "ethereum", "polygon-pos"), one or more contract addresses, and target fiat/crypto currencies, and receive current price data. Optional fields let you include market cap, 24-hour volume, and 24-hour price change alongside the price.
The endpoint is part of a broader CoinGecko proxy service hosted at coingecko.mpp.paywithlocus.com that exposes 15 routes covering simple prices, coin markets, market charts, trending coins, exchange rates, global stats, DeFi stats, categories, top gainers/losers, exchanges, search, coin history, and more. Each call costs 60,000 base units of pathUSD (currency 0x20c…8b50) on Tempo L2, which equals $0.06 per request assuming pathUSD uses 6 decimals.
The endpoint accepts POST requests with a JSON body. The OpenAPI spec is well-defined with required fields (platform_id, contract_addresses, vs_currencies) and optional boolean flags. Note that the probe's HEAD/GET attempts returned 404, which is expected since the route only accepts POST. No example response schema is provided in the OpenAPI spec, so the exact response shape should follow CoinGecko's documented /simple/token_price/{id} format.
Capabilities
Use cases
- —Fetching current USD/EUR prices for ERC-20 tokens by contract address in a trading bot
- —Building a portfolio tracker that resolves token values from contract addresses across multiple chains
- —Enriching on-chain transaction data with fiat-denominated token prices
- —Monitoring DeFi token prices with market cap and volume context
Fit
Best for
- —Agents needing token prices by contract address rather than coin ID
- —Pay-per-call access to CoinGecko data without managing API keys
- —Multi-chain token price resolution (Ethereum, Polygon, etc.)
- —Programmatic crypto market data retrieval with micropayments
Not for
- —High-frequency trading requiring sub-second latency and free bulk access
- —Historical OHLCV candle data (use the market-chart endpoint instead)
- —Non-crypto asset pricing
Quick start
curl -X POST https://coingecko.mpp.paywithlocus.com/coingecko/simple-token-price \
-H "Content-Type: application/json" \
-d '{"platform_id":"ethereum","contract_addresses":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","vs_currencies":"usd"}'Example
Request
{
"platform_id": "ethereum",
"vs_currencies": "usd",
"include_24hr_vol": true,
"contract_addresses": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"include_market_cap": true,
"include_24hr_change": true
}Endpoint
Quality
Full OpenAPI schema with clear request fields and payment info is available. However, the probe returned 404 on HEAD/GET (expected for POST-only routes, but no 402 challenge was captured), no response schema is documented, and no example responses exist. The crawl pages all returned generic 404 JSON. Price is inferrable from the OpenAPI x-payment-info.
Warnings
- —No 402 MPP challenge was captured — the endpoint only accepts POST, so the HEAD/GET probe missed it; liveness via POST is unconfirmed
- —No response schema documented in the OpenAPI spec; response shape is inferred from CoinGecko's public API documentation
- —pathUSD decimals assumed to be 6 (standard for USD stablecoins); if different, the $0.06 price estimate would be incorrect
- —LLM docs reference at https://beta.paywithlocus.com/mpp/coingecko.md was not crawled
Citations
- —The endpoint charges 60,000 base units of pathUSD per call via Tempo L2https://coingecko.mpp.paywithlocus.com
- —The OpenAPI spec lists 15 CoinGecko proxy routes including simple-token-pricehttps://coingecko.mpp.paywithlocus.com
- —Required fields are platform_id, contract_addresses, and vs_currencieshttps://coingecko.mpp.paywithlocus.com
- —Additional LLM documentation is referenced at https://beta.paywithlocus.com/mpp/coingecko.mdhttps://coingecko.mpp.paywithlocus.com