oraclePriceHistoryByTime

Returns oracle price updates for a coin within a time range in ascending order (oldest first).

Field	Type	Description
type	string	Must be "oraclePriceHistoryByTime"
coin	string	symbol e.g. "BTC" or with dex prefix "xyz:XYZ100"
startTime	int	ms unix timestamp
endTime	int	ms unix timestamp (optional)
limit	int	max 2000
dex	string	DEX identifier e.g. "hyna", "xyz" (optional, returns all if omitted)

Request

cURL

curl -X POST https://api.hydromancer.xyz/info \
-H "Authorization: Bearer $HYDROMANCER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
      "type": "oraclePriceHistoryByTime",
      "coin": "BTC",
      "startTime": 1765641292010,
      "endTime": 1765641295024
    }'

Python

Javascript

---

Response Fields

Field	Type	Description
time	int	Timestamp (ms)
dex	string	DEX identifier
coin	string	Trading pair
oraclePx	string?	Oracle price
markPx	string?	Mark price (first input)
markPx2	string?	Mark price (second input) — added from 2026-01-12, only present if hip3 dex pushes 2 mark prices
extPerpPx	string?	External perp price

Response (HIP-3 dex with 2 mark prices)

[
  {
    "time": 1767965552339,
    "dex": "xyz",
    "coin": "xyz:XYZ100",
    "oraclePx": "25546.00",
    "markPx": "25546.00",
    "markPx2": "25545.00",
    "extPerpPx": "25546.00"
  },
  {
    "time": 1767965555526,
    "dex": "xyz",
    "coin": "xyz:XYZ100",
    "oraclePx": "25555.00",
    "markPx": "25555.00",
    "markPx2": "25554.00",
    "extPerpPx": "25555.00"
  }
]

Response (HIP-3 dex with 1 mark price)

[
  {
    "time": 1767965617506,
    "dex": "hyna",
    "coin": "hyna:BTC",
    "oraclePx": "90527.00",
    "markPx": "90508.27",
    "extPerpPx": "90473.25"
  },
  {
    "time": 1767965620725,
    "dex": "hyna",
    "coin": "hyna:BTC",
    "oraclePx": "90528.00",
    "markPx": "90502.00",
    "extPerpPx": "90473.25"
  }
]