Historical Data

Access historical price data with configurable time ranges and intervals.

Get Historical Prices

GET/historical/price/:symbol

Returns historical VWAP prices for a symbol over a specified time range.

Query Parameters

Parameter	Type	Default	Description
startTime	string	required	Start time (ISO 8601)
endTime	string	required	End time (ISO 8601)
interval	string	1h	Data interval: 1m, 5m, 15m, 1h, 4h, 1d

Request

cURL

curl -X GET "https://api.predikt.fun/api/v1/historical/price/SOL?startTime=2026-01-16T00:00:00Z&endTime=2026-01-17T00:00:00Z&interval=1h" \
  -H "Authorization: Bearer pk_live_your_api_key"

Response

Field	Type	Description
requestId	string	Unique request identifier
symbol	string	The requested symbol
interval	string	Data interval used
startTime	string	Query start time (ISO 8601)
endTime	string	Query end time (ISO 8601)
dataPoints	array	Array of price points
dataPoints[].timestamp	string	ISO 8601 timestamp
dataPoints[].price	number	Price at timestamp
dataPoints[].source	string	Price source name
costUsd	string	Cost of request
remainingBalanceUsd	string	Remaining account balance

Response (200)

{
  "requestId": "req_abc123",
  "symbol": "SOL",
  "interval": "1h",
  "startTime": "2026-01-16T00:00:00.000Z",
  "endTime": "2026-01-17T00:00:00.000Z",
  "dataPoints": [
    { "timestamp": "2026-01-16T00:00:00.000Z", "price": 182.45, "source": "birdeye,coingecko" },
    { "timestamp": "2026-01-16T01:00:00.000Z", "price": 183.12, "source": "birdeye" },
    { "timestamp": "2026-01-16T02:00:00.000Z", "price": 184.56, "source": "coingecko" }
  ],
  "costUsd": "0.05",
  "remainingBalanceUsd": "45.95"
}

Available Intervals

Interval	Description	Max Range
1m	1 minute	24 hours
5m	5 minutes	7 days
15m	15 minutes	14 days
1h	1 hour (default)	30 days
4h	4 hours	90 days
1d	1 day	365 days

Pricing

Historical price data requests are charged at a flat rate:

$0.05 per request (max 1000 data points)