# BlockRun Perpetual Contract Snapshot

> BlockRun Perpetual Contract Snapshot is a paid API for AI agents from blockrun.ai, paid per call via x402, $0.0085/call, status unknown (last checked 2026-09-14).

Fetches a snapshot of perpetual contract data for a specified trading pair from a cryptocurrency exchange.

## Facts

- Endpoint: GET https://blockrun.ai/api/v1/surf/exchange/perp
- Price: $0.0085/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockrun-perpetual-contract-snapshot-88e9c73b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tUdveZkJYb9kZGJi-s_kx

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 blockrun-perpetual-contract-snapshot-88e9c73b
```

Example prompt: Can you pull the current perpetual contract snapshot for BTC-USDT from BlockRun, including funding rate and mark price?

## When to prefer this

Use this endpoint when you need a real-time or near-real-time snapshot of perpetual contract state (funding rate, mark price, open interest) for a specific trading pair, and you want pay-per-call access without managing API keys. Prefer this over OHLCV endpoints when you need live contract-level derivatives data rather than historical candlestick data.

## Known failure modes

- Missing or invalid 'pair' query parameter returns an error
- Unsupported or misspelled trading pair symbol returns no data or error
- Exchange data temporarily unavailable causes timeout or 5xx error
- Payment not settled (x402) results in 402 Payment Required response

## How this service works

Pay for the outcome. One endpoint for every model, tool and data source an agent needs — each call priced before it runs, at the best value per dollar. 103 models and 100 data and tool APIs.

## Output

A snapshot of perpetual contract data for the specified trading pair, likely including mark price, index price, funding rate, open interest, and other relevant contract state fields at the time of the call.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "pair": {
   "type": "string",
   "description": "Required query param"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockrun-perpetual-contract-snapshot-88e9c73b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from blockrun.ai](https://www.zero.xyz/host/blockrun.ai/llms.txt)