oraclePriceHistoryByTime

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

For HIP-3 dexes this endpoint returns the prices the dex deployer submitted in its setOracle action (markPx / markPx2 are the mark-price inputs). The prices the network accepted for the round — the ones used for margining and liquidation — are served by perpPriceHistoryByTime. For the native dex the two endpoints agree.

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

import requests
import os
import json

response = requests.post(
 'https://api.hydromancer.xyz/info',
 json={
        'type': 'oraclePriceHistoryByTime',
        'coin': 'BTC',
        'startTime': 1765641292010,
        'endTime': 1765641295024
 },
 headers={
          'Authorization': f'Bearer {os.environ["HYDROMANCER_API_KEY"]}',
          'Content-Type': 'application/json'
      }
)
print(json.dumps(response.json(), indent=2))

Javascript

import axios from 'axios';

const response = await axios.post(
  'https://api.hydromancer.xyz/info',
  {
    type: 'oraclePriceHistoryByTime',
    coin: 'BTC',
    limit: 100,
    startTime: 1765641292010,
    endTime: 1765641295024
  },
  {
    headers: {
      'Authorization': `Bearer ${process.env.HYDROMANCER_API_KEY}`,
      'Content-Type': 'application/json'
    }
  }
);

console.log(JSON.stringify(response.data, null, 2));

---

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"
  }
]