# ChainRay Batch Blockchain Data Query

> ChainRay Batch Blockchain Data Query is a paid API for AI agents from chainray.online, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Execute multiple on-chain intelligence queries in a single batched request across 46 blockchain networks

## Facts

- Endpoint: POST https://chainray.online/batch
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainray-batch-blockchain-data-query-e1061da2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ao-SmFVOk7WVKebaWVvBe

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 chainray-batch-blockchain-data-query-e1061da2 -d '<json body>'
```

Example prompt: Can you pull the current gas fees on Ethereum, the ETH/USDC price, and the DeFi TVL on Arbitrum all at once — I need all three data points together before I decide on a trade?

## When to prefer this

Use this batch endpoint when you need to fetch multiple types of on-chain data simultaneously across one or more chains — it is far more efficient than calling individual endpoints separately. Ideal when an agent needs to combine gas fees, token prices, DeFi metrics, wallet data, or transaction history in a single round-trip. Prefer this over individual ChainRay endpoints when latency and cost efficiency matter, since it bundles multiple queries into one $0.001 payment.

## Known failure modes

- Invalid query object structure returns 400 with validation error
- Unsupported chain ID in query returns error for that specific sub-query
- Payment not included or insufficient USDC results in 402 Payment Required
- Overly large batch with too many queries may hit rate or size limits
- Network congestion on queried chain may cause partial or delayed results

## How this service works

The most complete blockchain data and intelligence service for AI agents. 93 endpoints across 46 chains, from gas fees to DeFi analytics, with real-time streams, intent routing, and verifiable proofs. Pay-per-request via x402.

## Output

An array of results corresponding to each submitted query object, containing on-chain data such as gas fees, token prices, DeFi analytics, wallet data, or transaction history depending on the query types specified — returned as a batch response covering up to 46 supported chains.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "queries": {
   "type": "array",
   "items": {
    "type": "object"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainray-batch-blockchain-data-query-e1061da2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chainray.online](https://www.zero.xyz/host/chainray.online/llms.txt)