Global cryptocurrency market statistics via CoinGecko, pay-per-call over MPP/Tempo.
What it does
This endpoint returns global cryptocurrency market data from CoinGecko, including aggregate statistics such as total market capitalization, 24-hour trading volume, market dominance percentages, and active cryptocurrency/exchange counts. It is one of 15 endpoints in the CoinGecko via Locus MPP service, which wraps the CoinGecko API behind the Micropayment Protocol (MPP) so agents can pay per call without API keys.
The `/coingecko/global` endpoint accepts a POST request with no required body parameters and returns a summary of the entire crypto market. Sibling endpoints on the same service cover simple price lookups, token prices by contract address, market charts, coin history, trending coins, exchange rates, DeFi global stats, top gainers/losers, exchanges, categories, search, and coin lists. All endpoints are priced at 60,000 base units of pathUSD (currency 0x20c…8b50) on Tempo L2, which equals $0.06 per call assuming 6 decimals.
The probe did not receive a 402 challenge on HEAD or GET for this specific path (it returned 404), which is consistent with the OpenAPI spec declaring only POST methods. The endpoint is expected to be live when called via POST with a valid MPP payment. Documentation references include the CoinGecko API docs at docs.coingecko.com and an LLM-oriented skill file at beta.paywithlocus.com/mpp/coingecko.md.
Capabilities
Use cases
- —Fetching aggregate crypto market statistics for a dashboard or report
- —Monitoring total market capitalization and BTC dominance over time
- —Providing an AI agent with a real-time snapshot of the crypto market
- —Comparing global DeFi vs overall market metrics alongside the global-defi endpoint
- —Building automated alerts when total market cap crosses thresholds
Fit
Best for
- —AI agents needing pay-per-call crypto market data without API key management
- —Developers who want CoinGecko data settled via crypto micropayments on Tempo L2
- —Quick one-shot queries for aggregate market statistics
Not for
- —High-frequency trading requiring sub-second latency and streaming data
- —Users who already have a CoinGecko Pro API key and prefer direct access
- —Querying individual coin prices (use the simple-price or coin-data sibling endpoints instead)
Quick start
curl -X POST https://coingecko.mpp.paywithlocus.com/coingecko/global \
-H "Content-Type: application/json" \
-d '{}'Example
Request
{}Endpoint
Quality
The OpenAPI spec is well-structured with 15 documented paths and clear payment info, but the specific /coingecko/global endpoint has no request or response schema details. The probe returned 404 on HEAD/GET (expected since only POST is defined), so liveness via POST is inferred but not confirmed. No example responses are available. Price is clear from the spec.
Warnings
- —Probe returned 404 on HEAD and GET; endpoint only supports POST per the OpenAPI spec, so liveness is inferred but not directly confirmed.
- —No response schema is documented for /coingecko/global — the actual shape of the returned data is unknown from available materials.
- —Currency 0x20c000000000000000000000b9537d11c60e8b50 is assumed to be pathUSD with 6 decimals; if decimals differ, the $0.06 price would be incorrect.
Citations
- —The /coingecko/global endpoint is defined as POST with an amount of 60000 in currency 0x20c…8b50 on Tempohttps://coingecko.mpp.paywithlocus.com
- —CoinGecko API reference is available at docs.coingecko.comhttps://docs.coingecko.com
- —LLM-oriented documentation is at beta.paywithlocus.com/mpp/coingecko.mdhttps://beta.paywithlocus.com/mpp/coingecko.md
- —The service describes itself as providing cryptocurrency market data including prices, charts, market cap, exchanges, trending coins, global stats, NFTs, derivatives, and on-chain datahttps://coingecko.mpp.paywithlocus.com