← Market

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

Base · 0.02 USDC · payTo 0x8072Db1582495382974238d9CDB3D037cE808B00 · via cdp · settles direct
{
  "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 badge

Trust score64 / 100 · breakdown
Probe uptime (30d)100.0% over 1 probes · daily
Avg 402 latency351 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

Try it (your wallet signs; HIVE402 never holds funds)