{"slug":"agentshelf-syntexa-ch-v1-crypto-candles-e4eaf0","title":"Call when an agent needs OHLCV candles for a spot symbol and interval (1m, 5m, 1","host":"agentshelf.syntexa.ch","method":"POST","resource":"https://agentshelf.syntexa.ch/v1/crypto-candles","category":"code","description":"Call when an agent needs OHLCV candles for a spot symbol and interval (1m, 5m, 15m, 1h, 4h, 1d), limit up to 500. Tries Coinbase Exchange, Kraken, OKX, then Binance. No API key. Send JSON {\"symbol\":\"BTC-USD\",\"interval\":\"1h\",\"limit\":2}. Exact $0.005 USDC on Base. Try unpaid POST /v1/sandbox/crypto-ca","price_listed":0.005,"price_asked":null,"state":"effects","state_label":"Not tested: has real-world effects","checks_7d":0,"answered_7d":0,"latency_ms_median":null,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"interval":"1h","limit":2,"symbol":"BTC-USD"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":false,"examples":[{"interval":"1h","limit":2,"symbol":"BTC-USD"}],"properties":{"interval":{"description":"Candle size. One of 1m, 5m, 15m, 1h, 4h, or 1d. Coinbase has no 4h candles, so 4h uses the next venue.","enum":["1m","5m","15m","1h","4h","1d"],"examples":["1h"],"type":"string"},"limit":{"default":100,"description":"How many candles to return, newest included. Example: 2. Default 100. At most 500.","examples":[2],"maximum":500,"minimum":1,"type":"integer"},"symbol":{"description":"Spot symbol. Example: BTC-USD or BTCUSDT. XBT is read as BTC. A slash is accepted. The response symbol is BASE-QUOTE.","examples":["BTC-USD"],"maxLength":24,"minLength":5,"type":"string"}},"required":["symbol","interval"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"additionalProperties":false,"examples":[{"billed":true,"candles":[{"close":"82734.45","high":"82921.93","low":"82558.24","open":"82835.63","time":1792645200,"volume":"152.74657236"},{"close":"82480.26","high":"82819.65","low":"82437.8","open":"82734.44","time":1792648800,"volume":"101.78967861"}],"interval":"1h","limit":2,"ok":true,"receipt_id":"rcpt_01EXAMPLE000000000000000","source":"coinbase","symbol":"BTC-USD","warnings":[]}],"properties":{"billed":{"examples":[true],"type":"boolean"},"candles":{"examples":[[{"close":"82734.45","high":"82921.93","low":"82558.24","open":"82835.63","time":1792645200,"volume":"152.74657236"},{"close":"82480.26","high":"82819.65","low":"82437.8","open":"82734.44","time":1792648800,"volume":"101.78967861"}]],"items":{"additionalProperties":false,"properties":{"close":{"type":"string"},"high":{"type":"string"},"low":{"type":"string"},"open":{"type":"string"},"time":{"minimum":0,"type":"integer"},"volume":{"type":"string"}},"required":["time","open","high","low","close","volume"],"type":"object"},"maxItems":500,"type":"array"},"interval":{"enum":["1m","5m","15m","1h","4h","1d"],"examples":["1h"],"type":"string"},"limit":{"examples":[2],"exclusiveMinimum":0,"maximum":500,"type":"integer"},"ok":{"const":true,"examples":[true],"type":"boolean"},"receipt_id":{"examples":["rcpt_01EXAMPLE000000000000000"],"type":"string"},"source":{"enum":["coinbase","kraken","okx","binance"],"examples":["coinbase"],"type":"string"},"symbol":{"examples":["BTC-USD"],"type":"string"},"warnings":{"default":[],"examples":[[]],"items":{"type":"string"},"type":"array"}},"required":["ok","receipt_id","billed","symbol","interval","limit","source","candles"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[],"description_full":"Call when an agent needs OHLCV candles for a spot symbol and interval (1m, 5m, 15m, 1h, 4h, 1d), limit up to 500. Tries Coinbase Exchange, Kraken, OKX, then Binance. No API key. Send JSON {\"symbol\":\"BTC-USD\",\"interval\":\"1h\",\"limit\":2}. Exact $0.005 USDC on Base. Try unpaid POST /v1/sandbox/crypto-candles first.","last_updated":"2026-10-22T07:20:49.639Z","schemes":["exact"]}