List cryptocurrency categories with market data via CoinGecko, paid per call on Tempo L2.
What it does
This endpoint returns cryptocurrency category listings from CoinGecko's data, served through the Locus MPP (Micropayment Protocol) gateway. A POST to `/coingecko/categories` returns category data (e.g., DeFi, Layer 1, Meme tokens) with optional sorting by market cap or name. Each call costs 60,000 base units of pathUSD on Tempo L2, which equals $0.06 per request.
The endpoint is part of a broader CoinGecko MPP service hosted at `coingecko.mpp.paywithlocus.com` that exposes 15 routes covering simple prices, token prices by contract, coin markets, coin detail, coins list, search, trending, exchange rates, global stats, global DeFi stats, market charts, coin history, categories, top gainers/losers, and exchanges. All routes share the same per-call price of $0.06 and settle via the Tempo method (pathUSD on Tempo L2).
The categories endpoint accepts an optional `order` parameter (e.g., `market_cap_desc`, `name_asc`) in a JSON body. No authentication beyond the MPP payment challenge is required. Note that the probe returned 404 on HEAD/GET — the endpoint is POST-only, which is consistent with the OpenAPI spec declaring only POST methods. The OpenAPI schema is well-defined and the service appears operational.
Capabilities
Use cases
- —Retrieve a sorted list of all cryptocurrency categories with aggregate market data
- —Filter coins-markets results by category slug obtained from this endpoint
- —Build dashboards showing capital flows across crypto sectors
- —Compare category-level market caps over time for portfolio allocation
- —Power agent workflows that need to classify tokens by sector
Fit
Best for
- —AI agents needing structured crypto category data without API key management
- —Micropayment-based access to CoinGecko without a subscription
- —Programmatic discovery of all CoinGecko category slugs for downstream queries
Not for
- —High-frequency trading requiring sub-second latency
- —Free or bulk historical data downloads — each call costs $0.06
- —Non-crypto financial data
Quick start
curl -X POST https://coingecko.mpp.paywithlocus.com/coingecko/categories \
-H "Content-Type: application/json" \
-d '{"order": "market_cap_desc"}'Example
Request
{
"order": "market_cap_desc"
}Endpoint
Quality
The OpenAPI spec is detailed with 15 well-defined routes and clear payment info. However, the probe returned 404 because it used HEAD/GET while the endpoint is POST-only, so liveness via 402 challenge was not directly confirmed. No response examples are available, and crawled pages only returned generic 404 JSON. Docs reference external skill.md/llms.txt but those were not crawled.
Warnings
- —Probe did not capture a 402 MPP challenge because it used HEAD/GET; the endpoint is POST-only per the OpenAPI spec, so liveness is inferred but not directly confirmed.
- —No response schema or example responses are documented in the OpenAPI spec.
- —Currency address 0x20c000000000000000000000b9537d11c60e8b50 is assumed to be pathUSD with 6 decimals based on the Tempo settlement method; if decimals differ, the $0.06 price would be incorrect.
Citations
- —The /coingecko/categories endpoint uses POST with an optional 'order' parameter and costs 60000 base units via Tempo settlement.https://coingecko.mpp.paywithlocus.com
- —The service exposes 15 CoinGecko routes all priced at 60000 base units per call.https://coingecko.mpp.paywithlocus.com
- —CoinGecko provides cryptocurrency market data including prices, charts, market cap, exchanges, trending coins, global stats, NFTs, derivatives, and on-chain data.https://docs.coingecko.com
- —Docs references point to https://beta.paywithlocus.com/mpp/coingecko.md for LLM-oriented documentation.https://coingecko.mpp.paywithlocus.com