# BlockRun Onchain & Market Data Gateway

> BlockRun Onchain & Market Data Gateway is a paid API for AI agents from vaaya.ai, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-13).

Fetches onchain data, token prices, rankings, news, social mindshare, and prediction market odds from 103 endpoints via a single POST call using x402 micropayments.

## Facts

- Endpoint: POST https://vaaya.ai/api/run/blockrun/fetch
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockrun-onchain-market-data-gateway-02987f49
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZGIBKIsxEDVdctprcSN1u

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-onchain-market-data-gateway-02987f49 -d '<json body>'
```

Example prompt: Pull the current price and 24h ranking for ETH and BTC, and also check the Polymarket odds on the next Fed rate cut — use the surf/prices and pm/polymarket endpoints in BlockRun.

## When to prefer this

Choose BlockRun when you need broad coverage of crypto/onchain data and prediction markets through a single micropayment-based gateway, especially for agents that need to mix token prices, social sentiment, SQL onchain queries, and prediction market odds in one workflow without managing multiple API keys.

## Known failure modes

- Invalid endpoint name returns an error indicating unrecognized route
- Missing required query parameters returns a validation error
- Insufficient USDC balance or x402 payment failure blocks the request
- Rate limits or upstream data source outages may return 503 or timeout
- Malformed SQL in onchain queries returns a query parse error

## How this service works

BlockRun — 103 onchain & market-data endpoints over x402: surf/* (prices, rankings, news, onchain SQL, social mindshare) and pm/* prediction markets (Polymarket, Kalshi, sports, Binance candles). GET { endpoint, ...query }. Mostly 1-2¢ caps. See onchain-data knowledge doc or vaaya/discover.

## Output

Returns structured JSON containing the requested onchain or market data — prices, rankings, odds, candles, news items, social scores, or SQL result rows — depending on which of the 103 sub-endpoints is targeted.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockrun-onchain-market-data-gateway-02987f49/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vaaya.ai](https://www.zero.xyz/host/vaaya.ai/llms.txt)