# DeepSearch Crypto Market Context API

> DeepSearch Crypto Market Context API is a paid API for AI agents from x402.deepsearch.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Returns global crypto market snapshot including top gainers, BTC dominance, and total market cap, paid per-query with USDC on Base Mainnet

## Facts

- Endpoint: GET https://x402.deepsearch.com/v1/context/crypto/market
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/deepsearch-crypto-market-context-api-b248c72b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_M5kM7mIqgsM_x48uahydf

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 deepsearch-crypto-market-context-api-b248c72b
```

Example prompt: What are today's top gaining crypto tokens, Bitcoin's market dominance, and the total global crypto market cap right now?

## When to prefer this

Use this endpoint when you need a quick, pay-per-query global crypto market snapshot without a subscription — especially useful for one-off lookups of BTC dominance, global market cap, or top gaining tokens. Prefer this over subscription-based services when query volume is low or sporadic.

## Known failure modes

- Payment not received or USDC transaction fails on Base Mainnet — returns 402 Payment Required
- Invalid or missing query parameters — returns 400 Bad Request
- Market data temporarily unavailable — returns 503 Service Unavailable
- Rate limit exceeded — returns 429 Too Many Requests
- Stale or delayed data if upstream market feed is lagging

## How this service works

Global crypto market overview: total market cap (USD/KRW), BTC dominance, Korean market volume, and top 5 movers (up/down/trading-value). Updated every 10 minutes.

## Output

Returns a JSON object with top gaining tokens (symbol, price in KRW, up ratio percentage), BTC dominance percentage, and total global market cap in USD — e.g. BTC at 60.6% dominance, global cap at $2.4T, with top gainers listed by price and gain ratio.

## Example request

```json
{
 "required": "Samsung Electronics",
 "properties": "financials"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "topGainers": [
   {
    "price": "108M KRW",
    "symbol": "BTC",
    "upRatio": "5.2%"
   }
  ],
  "btcDominance": "60.6%",
  "globalMarketCapUSD": "2.4T"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/deepsearch-crypto-market-context-api-b248c72b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.deepsearch.com](https://www.zero.xyz/host/x402.deepsearch.com/llms.txt)