X402 · Get Market Candles
Retrieve historical OHLCV candles for an instrument or two-ticker spread. Returns up to 1000 bars per paid request, with UTC timestamps in seconds and data-delay information. Use search_tickers to find a ticker, get_market_snapshot for its latest market data, and get_market_technical_analysis for chart analysis of the same ticker. Popular examples include AAPL, SPY, gold XAUUSD (C:XAUUSD), EURUSD (C:EURUSD), BTCUSD (X:BTCUSD), and ETHUSD (X:ETHUSD). FX/metals require C:; crypto requires X:.
POST https://ai.tradeos.xyz/api/x402/get_market_candles
0.02 USDC on Base · payTo 0x8072Db1582495382974238d9CDB3D037cE808B00
Status: verified · payable
Operator badge: embed this endpoint's live status badge — it reads "Verified Payable" only while the probe record backs it.
Settlement: direct to the seller's payTo — 0% HIVE402 take
Payment routes
{
"interval": "1D",
"limit": 100,
"ticker": "AAPL"
}{
"candles": [
{
"close": 203,
"high": 205,
"low": 199,
"open": 200,
"timestamp": 1735828200,
"volume": 1000000
}
],
"count": 1,
"delaySeconds": 900,
"interval": "1D",
"nextEndTime": null,
"ok": true,
"status": "ok",
"ticker": "AAPL",
"timestampUnit": "seconds",
"timezone": "UTC"
}Script Master Labs LLC · SDVOSB · Kinston, NC · Terms · Refunds · Privacy · Contact
SML network: ScriptMasterLabs — the main site · SML Dual Market — the human storefront · VA Ratings — VA disability ratings, free for veterans
Agent intel 
| Trust score | 64 / 100 · breakdown |
|---|---|
| Probe uptime (30d) | 100.0% over 1 probes · daily |
| Avg 402 latency | 351 ms |
| Paid calls (30d, on-chain) | 0 calls · 0 buyers |
| Facilitator-reported (30d) | 3 calls · 1 payers (CDP Bazaar) |
How to call
POST https://ai.tradeos.xyz/api/x402/get_market_candles · input in body · spec from live-challenge
Input schema
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"pattern": "^[A-Za-z0-9._:]{1,64}(?:\\s*[/-]\\s*[A-Za-z0-9._:]{1,64})?$",
"description": "AAPL, C:EURUSD, X:BTCUSD, or a two-ticker ratio/difference"
},
"interval": {
"type": "string",
"enum": [
"1",
"5",
"15",
"30",
"60",
"240",
"1D",
"1W",
"4W",
"1m",
"5m",
"15m",
"30m",
"1h",
"4h"
]
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 1000,
"default": 100
},
"startTime": {
"type": "integer",
"minimum": 0,
"maximum": 9999999999,
"description": "Inclusive UTC Unix timestamp in seconds"
},
"endTime": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9999999999,
"description": "Exclusive UTC Unix timestamp in seconds; defaults to now"
}
},
"required": [
"ticker",
"interval"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output schema
{
"type": "object"
}curl -i -X POST 'https://ai.tradeos.xyz/api/x402/get_market_candles' \
-H 'content-type: application/json' -d '{"ticker":"AAPL","interval":"1D","limit":100}'
Agents: POST https://hive402.scriptmasterlabs.com/mcp → route_task / proxy_call · SDK /sdk/hive402.mjs