Global DeFi market statistics from CoinGecko via pay-per-call MPP endpoint
What it does
This endpoint provides global DeFi market data sourced from CoinGecko, served through the Locus MPP (Micropayment Protocol) gateway. The `/coingecko/global-defi` path returns aggregate DeFi statistics — typically including total DeFi market cap, DeFi-to-ETH ratio, trading volume, and top DeFi coins by market cap. It is one of 15 CoinGecko endpoints available on this MPP service, which collectively cover simple prices, token prices by contract, market charts, coin history, trending coins, exchange rates, categories, top gainers/losers, exchanges, and more.
Payment is handled via the Tempo method (pathUSD on Tempo L2) at 60,000 base units per call. With pathUSD using 6 decimals, this works out to $0.06 per request. The endpoint accepts POST requests with no required request body — it simply returns the current global DeFi snapshot. The probe returned 404 on HEAD/GET, which is expected since the OpenAPI spec defines this as a POST-only endpoint.
The service is part of the broader Locus MPP platform that proxies CoinGecko's API. Documentation is referenced at https://beta.paywithlocus.com/mpp/coingecko.md and the upstream CoinGecko API reference at https://docs.coingecko.com. No response schema is documented in the OpenAPI spec, so the exact response structure must be inferred from CoinGecko's own documentation for the `/global/decentralized_finance_defi` endpoint.
Capabilities
Use cases
- —Fetching aggregate DeFi market statistics for dashboards or reports
- —Monitoring DeFi market cap and trading volume trends over time
- —Building AI agents that need real-time DeFi market context
- —Comparing DeFi market share relative to overall crypto market
Fit
Best for
- —Agents needing quick DeFi market snapshots without API key management
- —Pay-per-call access to CoinGecko data without a subscription
- —Automated workflows requiring global DeFi statistics
Not for
- —Granular per-protocol DeFi analytics (TVL breakdowns, individual protocol data)
- —High-frequency trading requiring sub-second latency
- —Free or bulk data access — each call costs $0.06
Quick start
curl -X POST https://coingecko.mpp.paywithlocus.com/coingecko/global-defi \
-H "Content-Type: application/json"Example
Request
{}Response
{
"data": {
"top_coin_name": "Lido Staked Ether",
"defi_dominance": "3.85",
"eth_market_cap": "234567890123.45",
"defi_market_cap": "87654321098.12",
"defi_to_eth_ratio": "37.36",
"trading_volume_24h": "5432109876.78",
"top_coin_defi_dominance": 15.2
}
}Endpoint
Quality
The OpenAPI spec is well-structured with 15 documented paths and clear payment info, but the specific /global-defi endpoint has no request body schema and no response schema. The probe returned 404 because HEAD/GET were used on a POST-only endpoint, so liveness is not confirmed but is plausible. No crawled documentation was available; response structure is inferred from upstream CoinGecko docs.
Warnings
- —Endpoint liveness not directly confirmed — probe used HEAD/GET but endpoint is POST-only
- —No response schema provided in OpenAPI spec; response structure inferred from CoinGecko upstream API
- —Currency address 0x20c000000000000000000000b9537d11c60e8b50 assumed to be pathUSD with 6 decimals based on Tempo method convention
Citations
- —The endpoint is defined as POST with amount 60000 and method tempo in the OpenAPI spechttps://coingecko.mpp.paywithlocus.com
- —CoinGecko API reference is available at docs.coingecko.comhttps://docs.coingecko.com
- —LLM-specific documentation referenced at beta.paywithlocus.comhttps://beta.paywithlocus.com/mpp/coingecko.md