Pay-per-call CoinGecko crypto price data via MPP (Tempo/pathUSD settlement)
What it does
This endpoint exposes CoinGecko's Simple Price API through the Locus MPP (Micropayment Protocol) gateway. It accepts a POST request with comma-separated coin IDs and target fiat/crypto currencies, returning current prices along with optional market cap, 24-hour volume, 24-hour change, and last-updated timestamps. Each call costs 60,000 base units of pathUSD on Tempo L2 (approximately $0.06 per request, assuming 6 decimals for pathUSD).
The broader CoinGecko via Locus MPP service includes 15 endpoints covering simple prices, token prices by contract address, coins markets, coin detail data, coins list, search, trending coins, exchange rates, global market stats, global DeFi stats, market charts, coin history, categories, top gainers/losers, and exchanges. All endpoints share the same per-call pricing and settlement method. The OpenAPI 3.1.0 spec provides full request schemas with required and optional parameters.
The endpoint is a POST-only route. Probe attempts via HEAD and GET returned 404, which is expected since the OpenAPI spec defines only POST. No response schema examples were captured, so the exact response shape should be assumed to mirror the upstream CoinGecko /simple/price response format. Documentation references point to https://docs.coingecko.com for the underlying API and https://beta.paywithlocus.com/mpp/coingecko.md for MPP-specific guidance.
Capabilities
Use cases
- —AI agents fetching real-time crypto prices to answer user queries
- —Trading bots checking current prices and 24h changes before executing strategies
- —Portfolio dashboards pulling market cap and sparkline data for display
- —Research tools querying historical coin data and market charts
- —Notification services monitoring top gainers and losers
Fit
Best for
- —Agents needing pay-per-call crypto price data without API key management
- —Low-volume or bursty crypto data lookups settled on-chain
- —Programmatic access to CoinGecko data via a standardized MPP interface
Not for
- —High-frequency trading requiring sub-second latency and free bulk access
- —Users who already have a CoinGecko Pro API key and want direct access
- —Non-crypto financial data (stocks, forex, commodities)
Quick start
curl -X POST https://coingecko.mpp.paywithlocus.com/coingecko/simple-price \
-H "Content-Type: application/json" \
-d '{"ids": "bitcoin,ethereum", "vs_currencies": "usd"}'Example
Request
{
"ids": "bitcoin,ethereum",
"precision": "2",
"vs_currencies": "usd,eur",
"include_24hr_vol": true,
"include_market_cap": true,
"include_24hr_change": true,
"include_last_updated_at": true
}Response
{
"bitcoin": {
"eur": 62100.45,
"usd": 67432.12,
"eur_24h_vol": 26200000000,
"usd_24h_vol": 28500000000,
"eur_24h_change": 2.28,
"eur_market_cap": 1222000000000,
"usd_24h_change": 2.35,
"usd_market_cap": 1327000000000,
"last_updated_at": 1700000000
},
"ethereum": {
"eur": 3243.1,
"usd": 3521.78,
"eur_24h_vol": 14000000000,
"usd_24h_vol": 15200000000,
"eur_24h_change": 1.75,
"eur_market_cap": 389000000000,
"usd_24h_change": 1.82,
"usd_market_cap": 423000000000,
"last_updated_at": 1700000000
}
}Endpoint
Quality
Full OpenAPI 3.1.0 schema with request bodies and payment info for 15 endpoints. However, the specific endpoint returned 404 on HEAD/GET (expected for POST-only), no actual 402 challenge was captured for the POST method, no response schema is provided, and the example response is inferred from upstream CoinGecko docs rather than observed. The pathUSD currency address and decimal count are assumed (6 decimals) but not confirmed in the probe.
Warnings
- —No 402 MPP challenge was captured because the probe only tried HEAD and GET; the endpoint is POST-only per the OpenAPI spec, so liveness via MPP challenge is unconfirmed
- —The currency 0x20c000000000000000000000b9537d11c60e8b50 is assumed to be pathUSD with 6 decimals; if decimals differ, the $0.06 price estimate would be wrong
- —No response schema is provided in the OpenAPI spec; response format is inferred from upstream CoinGecko API documentation
- —Example response is synthetic, based on CoinGecko's known response shape, not observed from this endpoint
Citations
- —The OpenAPI spec defines 15 POST endpoints under coingecko.mpp.paywithlocus.com with payment amount 60000 and method tempohttps://coingecko.mpp.paywithlocus.com
- —API reference documentation is at docs.coingecko.comhttps://docs.coingecko.com
- —MPP-specific documentation is at beta.paywithlocus.com/mpp/coingecko.mdhttps://beta.paywithlocus.com/mpp/coingecko.md
- —The endpoint requires ids and vs_currencies as required parametershttps://coingecko.mpp.paywithlocus.com