Historic OHLC

Retrieve Open, High, Low, Close (OHLC) candlestick data for a token.

Endpoint

GET https://enterprise.guardis.io/v1/market/ohlc

Authentication

Include your API key in the X-API-Key header.

X-API-Key: your_api_key_here

---

Query Parameters

Parameter	Type	Required	Description
token_address	string	Yes	The mint address of the token
start	string	No	Start time in ISO 8601 format (e.g., "2024-01-01T00:00:00Z")
end	string	No	End time in ISO 8601 format (e.g., "2024-01-02T00:00:00Z")
interval	string	No	Candle interval: "30s", "1m", "5m", "15m", "30m", "1h", "4h", "1d" (defaults to "5m")
metric	string	No	Whether you need price or market cap

---

Example Request

curl -X GET "https://enterprise.guardis.io/v1/market/ohlc?token_address=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263" \
  -H "X-API-Key: your_api_key_here"

With custom time range:

curl -X GET "https://enterprise.guardis.io/v1/market/ohlc?token_address=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263&start=2024-01-15T00:00:00Z&end=2024-01-16T00:00:00Z&interval=1h" \
  -H "X-API-Key: your_api_key_here"

---

Response Format

{
  "timeframes": {
    "5m": [
      {
        "timestamp": "2025-01-15T10:00:00Z",
        "open": "0.000342",
        "high": "0.000358",
        "low": "0.000339",
        "close": "0.000351",
        "volume": "48293.47",
        "vwap": "0.000349"
      },
      {
        "timestamp": "2025-01-15T10:05:00Z",
        "open": "0.000351",
        "high": "0.000362",
        "low": "0.000348",
        "close": "0.000359",
        "volume": "52847.29",
        "vwap": "0.000355"
      }
    ]
  }
}

---

Field Reference

Response Structure

Field	Type	Description
timeframes	object	Map of interval names to arrays of OHLC data points

OHLC Data Point

Field	Type	Description
timestamp	string	ISO 8601 timestamp for the start of the candle period
open	string	Opening price at the start of the period
high	string	Highest price during the period
low	string	Lowest price during the period
close	string	Closing price at the end of the period
volume	string	Total trading volume during the period in USD
vwap	string	Volume-weighted average price during the period

Note: Decimal values are returned as strings to preserve precision.

---

Supported Metrics

Interval	Description
price_usd	Pulls the price in candlesticks
marketcap_usd	Pulls the marketcap in candlestics

---

Supported Intervals

Interval	Description
30s	30 seconds
1m	1 minute
5m	5 minutes
15m	15 minutes
30m	30 minutes
1h	1 hour
4h	4 hours
1d	1 day

---

Example Usage

JavaScript:

const tokenAddress = "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263";

const response = await fetch(
  `https://enterprise.guardis.io/v1/market/ohlc?token_address=${tokenAddress}&interval=1h`,
  {
    headers: {
      "X-API-Key": "your_api_key_here"
    }
  }
);

const data = await response.json();

// Access 1-hour candles
const candles = data.timeframes["1h"];
candles.forEach(candle => {
  console.log(`${candle.timestamp}: O=${candle.open} H=${candle.high} L=${candle.low} C=${candle.close}`);
});

Python:

import requests

token_address = "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"

response = requests.get(
    "https://enterprise.guardis.io/v1/market/ohlc",
    params={
        "token_address": token_address,
        "interval": "1h"
    },
    headers={"X-API-Key": "your_api_key_here"}
)

data = response.json()

# Access 1-hour candles
for candle in data["timeframes"]["1h"]:
    print(f"{candle['timestamp']}: O={candle['open']} H={candle['high']} L={candle['low']} C={candle['close']}")

---

Error Responses

Status Code	Description
400	Missing or invalid token_address parameter
401	Missing or invalid API key
404	OHLC data not found for the provided token
500	Internal server error

{
  "code": 400,
  "message": "Missing required parameter: token_address"
}

{
  "code": 404,
  "message": "OHLC data not found for the provided token address"
}