Historical price, volume, and market-cap chart data for any cryptocurrency via CoinGecko, pay-per-call over MPP.
What it does
This endpoint provides historical market chart data for cryptocurrencies sourced from CoinGecko, served through the Locus MPP (Micropayment Protocol) gateway. By POSTing a coin ID, target currency, and time range (1 to 365 days or "max"), you receive time-series arrays of prices, market caps, and total volumes. Optional parameters let you control the data interval (daily, hourly, or 5-minutely) and decimal precision.
The endpoint is part of a broader CoinGecko proxy service hosted at coingecko.mpp.paywithlocus.com that exposes 15 endpoints covering simple prices, token prices by contract, coins markets, coin detail, coins list, search, trending, exchange rates, global stats, global DeFi stats, market charts, coin history, categories, top gainers/losers, and exchanges. Each call is charged individually at 60,000 base units of pathUSD on Tempo L2 (approximately $0.06 per request, assuming pathUSD uses 6 decimals).
The endpoint accepts POST requests with a JSON body. Required fields are `id` (e.g. "bitcoin"), `vs_currency` (e.g. "usd"), and `days` (e.g. "30"). The MPP challenge uses intent "charge" and method "tempo", meaning each call is a one-shot payment settled on Tempo L2. Note that HEAD/GET probes returned 404, which is expected since this endpoint only accepts POST.
Capabilities
Use cases
- —Fetching 30-day or 90-day price charts for a portfolio dashboard
- —Building automated trading signals from historical price and volume data
- —Generating crypto market reports with time-series visualizations
- —Comparing historical performance of multiple cryptocurrencies
- —Powering AI agents that need on-demand crypto price history without API key management
Fit
Best for
- —AI agents needing keyless, pay-per-call access to CoinGecko chart data
- —Developers who want to avoid CoinGecko API key management and rate-limit tiers
- —Applications requiring historical price, volume, and market-cap arrays for any coin
- —Micropayment-native workflows on Tempo L2
Not for
- —Real-time streaming or WebSocket price feeds
- —Bulk historical data downloads requiring thousands of calls (cost adds up at ~$0.06/call)
- —Users who already have a CoinGecko Pro API key with higher rate limits
Quick start
curl -X POST https://coingecko.mpp.paywithlocus.com/coingecko/market-chart \
-H "Content-Type: application/json" \
-d '{"id": "bitcoin", "vs_currency": "usd", "days": "30"}'Example
Request
{
"id": "bitcoin",
"days": "30",
"interval": "daily",
"precision": "2",
"vs_currency": "usd"
}Response
{
"prices": [
[
1717200000000,
67500.12
],
[
1717286400000,
68100.45
]
],
"market_caps": [
[
1717200000000,
1330000000000
],
[
1717286400000,
1342000000000
]
],
"total_volumes": [
[
1717200000000,
25000000000
],
[
1717286400000,
27000000000
]
]
}Endpoint
Quality
Full OpenAPI schema with clear request parameters and pricing info is available. However, the endpoint returned 404 on HEAD/GET probes (expected for POST-only), no 402 challenge was directly captured, response schema is not documented, and crawled pages returned only error JSON. The response example is inferred from CoinGecko's known API shape, not directly observed.
Warnings
- —No 402 MPP challenge was captured during probing — endpoint only accepts POST, so liveness could not be confirmed via HEAD/GET
- —Response schema is not documented in the OpenAPI spec; the example response is inferred from CoinGecko's public API documentation
- —Price of 60,000 base units assumed to be pathUSD with 6 decimals ($0.06); if decimals differ, actual cost would change
- —No crawled documentation was available from the provider beyond error pages
Citations
- —The endpoint is documented in the OpenAPI spec as POST /coingecko/market-chart with required fields id, vs_currency, and dayshttps://coingecko.mpp.paywithlocus.com
- —Each call costs 60,000 base units of pathUSD settled via Tempo L2 (method: tempo, intent: charge)https://coingecko.mpp.paywithlocus.com
- —CoinGecko API reference is available at docs.coingecko.comhttps://docs.coingecko.com
- —Additional LLM-oriented docs referenced at beta.paywithlocus.com/mpp/coingecko.mdhttps://beta.paywithlocus.com/mpp/coingecko.md