# BlackForge Crypto Market Data – Latest Snapshot

> BlackForge Crypto Market Data – Latest Snapshot is a paid API for AI agents from api.blackforge.so, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-31).

Returns the latest OHLCV and order-book depth metrics for a given crypto trading pair on a specified spot exchange, with configurable column selection and time bucket granularity.

## Facts

- Endpoint: GET https://api.blackforge.so/v1/latest?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blackforge-crypto-market-data-latest-snapshot-88a8de79
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YyExtUo3M6UaagLYpuDRt

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 blackforge-crypto-market-data-latest-snapshot-88a8de79
```

Example prompt: Pull the latest price and order-book depth for BTCUSDT on Binance from BlackForge — I need the upDepth30 and downDepth5 columns.

## When to prefer this

Choose this endpoint when you need the latest snapshot of spot market data — price, depth, or custom metrics — for a specific crypto pair on one of the nine supported major exchanges (Binance, Bitget, Bybit, Coinbase, Gate, Kraken, KuCoin, MEXC, OKX). Ideal for trading bots, dashboards, and risk monitors that need real-time or near-real-time data with flexible column selection. The pay-per-call x402 model (0.005 USDC) suits low-frequency or event-driven queries without subscription overhead.

## Known failure modes

- Unknown or unsupported trading pair symbol returns an error or empty result
- Exchange enum value not in allowed list causes validation failure
- Missing required 'exchange' or 'symbol' query parameters causes 400 error
- Pair not listed on the specified exchange returns no data
- Payment failure or insufficient USDC balance prevents access (x402 protocol)
- Rate limiting or quota exhaustion returns 429 error

## How this service works

BlackForge crypto market data from the major spot exchanges: every column, 1-minute to daily buckets, 90-day lookback. Covers 100 billable rows; finer buckets and premium columns count as more than one row each.

## Output

A JSON object containing a Unix millisecond timestamp and a 'values' map of requested metric keys (e.g. price, upDepth30, downDepth5) reflecting the most recent data point for the specified exchange and trading pair. Default response includes all available columns; specifying columns reduces billable row count.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "exchange",
      "symbol"
     ],
     "properties": {
      "symbol": {
       "type": "string",
       "description": "Pair symbol, base then quote with no separator, such as BTCUSDT."
      },
      "columns": {
       "type": "string",
       "description": "Comma-separated metric keys from GET /v1/catalog. Omitted means every column."
      },
      "exchange": {
       "enum": [
        "binance",
        "bitget",
        "bybit",
        "coinbase",
        "gate",
        "kraken",
        "kucoin",
        "mexc",
        "okx"
       ],
       "type": "string",
       "description": "Spot exchange the pair trades on."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ts": 1793275200000,
  "values": {
   "price": 112840.5,
   "upDepth30": 91234567.8,
   "downDepth5": 48211034.2
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blackforge-crypto-market-data-latest-snapshot-88a8de79/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.blackforge.so](https://www.zero.xyz/host/api.blackforge.so/llms.txt)