OHLCV candlestick data for any token via x402 micropayment — multi-chain, Bitquery-powered.
What it does
This endpoint returns OHLCV (Open, High, Low, Close, Volume) candlestick chart data for any token, sourced from Bitquery's on-chain DEX trade indexing. It is part of the Einstein AI x402 API suite hosted at emc2ai.io. The endpoint accepts a POST request with a token contract address, optional chain selection (base, ethereum, bsc, arbitrum, polygon, optimism, solana), and a configurable time period (1h, 4h, 24h, 7d, 30d). The '/raw' variant returns structured data without AI-generated analysis, making it suitable for programmatic consumption by trading bots and charting agents.
Payment is handled via the x402 protocol — no API keys are needed. The endpoint costs $0.25 per request, payable in USDC on Base (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913), USDC on Solana, or 328 sats via Lightning Network. The 402 challenge was captured live and confirms the endpoint is operational. Payment is sent in the X-PAYMENT header as a Base64-encoded signed authorization.
The broader Einstein AI platform offers over 20 x402 endpoints covering market data, whale intelligence, launchpad monitoring (Pump.fun, Zora), security audits (rug pull scanner, MEV detection), arbitrage scanning, and an autonomous AI agent endpoint. Prices across the suite range from $0.25 to $1.15 per call. Supported chains include Base, Ethereum, BSC, Arbitrum, Polygon, Optimism, zkSync, and Solana depending on the endpoint.
Capabilities
Use cases
- —Feeding OHLCV bars into a trading bot for automated technical analysis
- —Building a charting UI that displays candlestick data for any EVM or Solana token
- —An AI agent autonomously fetching price history to evaluate token momentum before a trade
- —Backtesting trading strategies against historical DEX price data
- —Monitoring price action of newly launched tokens across multiple chains
Fit
Best for
- —AI agents needing pay-per-call candlestick data without API key management
- —Multi-chain token price analysis across 7 supported networks
- —Developers building on x402 who want structured OHLCV output without AI commentary
Not for
- —High-frequency tick-level data (this returns candle bars, not individual trades)
- —Free or unlimited-volume data needs (each call costs $0.25)
- —Centralized exchange (CEX) price data — this indexes DEX trades only
Quick start
curl -X POST https://emc2ai.io/x402/bitquery/candles/raw \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <base64-signed-usdc-authorization>" \
-d '{"tokenAddress": "0x0b3e328455c4059EEb9e3f84b5543F74E24e7E1b", "chain": "base", "timeperiod": "24h"}'Example
Request
{
"chain": "base",
"timeperiod": "24h",
"tokenAddress": "0x0b3e328455c4059EEb9e3f84b5543F74E24e7E1b"
}Response
{
"result": {
"candles": [
{
"low": 0.00228,
"high": 0.00251,
"open": 0.00234,
"time": "2025-01-15T12:00:00Z",
"close": 0.00245,
"volume": 158432.5
}
]
},
"status": "completed",
"payment": {
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "250000",
"scheme": "exact",
"txHash": "0xabc123...",
"network": "base",
"x402Version": 1
}
}Endpoint
Quality
Live 402 challenge confirmed on three payment networks with full outputSchema. Comprehensive OpenAPI spec with detailed request schemas. Deducted because no actual 200 response example is available in the docs (response body is inferred from the generic BitqueryResponse schema), and the /api route returned a 522 timeout during crawl.
Warnings
- —The /api route returned a Cloudflare 522 (origin timeout) during crawl, suggesting occasional backend instability.
- —No actual sample 200 response body is documented for this specific endpoint; the example_response_json is inferred from the generic BitqueryResponse schema.
- —The 'raw' suffix on this endpoint path is not explicitly documented in the OpenAPI spec — the closest documented endpoint is /x402/bitquery/ohlcv at $0.35, while this /candles/raw variant advertises $0.25.
Citations
- —Endpoint returns 402 with x402Version 1, accepting USDC on Base (250000 atomic = $0.25), USDC on Solana, and 328 sats on Lightninghttps://emc2ai.io/x402/bitquery/candles/raw
- —Supported chains include base, ethereum, bsc, arbitrum, polygon, optimism, solana with time periods 1h, 4h, 24h, 7d, 30dhttps://emc2ai.io/x402/bitquery/candles/raw
- —Einstein AI x402 API is described as AI-powered blockchain intelligence API with x402 micropayments, pay-per-request using USDC on Base, no API keys requiredhttps://emc2ai.io
- —Prices across the suite range from $0.25 to $1.15 per callhttps://emc2ai.io
- —Payment is via X-PAYMENT header with Base64-encoded signed USDC TransferWithAuthorization payloadhttps://emc2ai.io
- —Paid features typically cost $0.20–$1.00 per invocation with holdings-based discounts up to 60%https://emc2ai.io/docs