# CoinGecko Global Crypto Market Stats via Locus x402

> CoinGecko Global Crypto Market Stats via Locus x402 is a paid API for AI agents from coingecko.x402.paywithlocus.com, paid per call via x402, $0.06/call, status unknown (last checked 2026-09-14).

Fetches global cryptocurrency market statistics including total market cap, trading volume, dominance, and aggregate metrics across all coins and exchanges.

## Facts

- Endpoint: POST https://coingecko.x402.paywithlocus.com/coingecko/global
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coingecko-global-crypto-market-stats-via-locus-x402-a7c506c7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VedxY6zeR5_zth3R1sTqi

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability coingecko-global-crypto-market-stats-via-locus-x402-a7c506c7 -d '<json body>'
```

Example prompt: What does the global crypto market look like right now — total market cap, BTC dominance, and overall 24-hour volume?

## When to prefer this

Use this endpoint when you need aggregate, global-level cryptocurrency market statistics rather than data about a specific coin. Prefer this over coin-specific endpoints when the user wants BTC dominance, total market cap across all assets, or a macro view of the crypto ecosystem. Useful for market briefings, dashboards, and portfolio context-setting. Requires x402 micropayment (~$0.06 USDC) so best used on-demand rather than in high-frequency polling loops.

## Known failure modes

- Payment failure if USDC balance is insufficient or x402 payment header is missing/invalid
- CoinGecko API rate limit or upstream outage returning an error in the data field
- Malformed request body causing a 400-level error
- Network timeout if CoinGecko upstream is slow

## How this service works

Cryptocurrency market data — prices, charts, market cap, exchanges, trending coins, global stats, NFTs, derivatives, and on-chain data.

## Output

Returns a JSON object with global cryptocurrency market data including total active cryptocurrencies, total markets, market cap in various currencies, total 24h volume, market cap percentage by coin (BTC dominance etc.), and market cap change percentage over 24 hours. Also includes x402 payment confirmation fields (settled USDC amount, request ID, status URL).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "properties": {},
     "additionalProperties": true
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "payment": {
   "scheme": "exact",
   "settledUsdc": "0.001000",
   "authorizedMaxUsdc": "0.001000"
  },
  "request": {
   "id": "00000000-0000-4000-8000-000000000000",
   "statusUrl": "/requests/00000000-0000-4000-8000-000000000000"
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/coingecko-global-crypto-market-stats-via-locus-x402-a7c506c7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from coingecko.x402.paywithlocus.com](https://www.zero.xyz/host/coingecko.x402.paywithlocus.com/llms.txt)