Market History

Get Price History

Retrieve historical price snapshots for charting and analysis.

GET /markets/{market_address}/history

string

required

The market address.

string

default:"1h"

Time interval for data points: 1m, 5m, 15m, 1h, 4h, 1d

integer

default:"100"

Number of data points to return (max 1000).

curl "https://api.orica.markets/markets/ABC123.../history?interval=1h&limit=24"

const response = await fetch(
  `https://api.orica.markets/markets/${address}/history?interval=1h&limit=24`
);
const history = await response.json();

Response

[
  {
    "timestamp": 1704067200,
    "market_caps": [1500.00, 2000.00],
    "supplies": [15000, 20000],
    "volume": 35000.50
  },
  {
    "timestamp": 1704070800,
    "market_caps": [1550.00, 1980.00],
    "supplies": [15500, 19800],
    "volume": 35150.75
  }
]

Response Fields

number

Unix timestamp for this data point (aligned to interval).

number[]

Market cap for each outcome in USDC.

number[]

Share supply for each outcome.

number

Cumulative volume in USDC at this point.

Get Volume Metrics

Retrieve aggregate volume statistics for a market.

GET /markets/{market_address}/volume

curl "https://api.orica.markets/markets/ABC123.../volume"

const response = await fetch(
  `https://api.orica.markets/markets/${address}/volume`
);
const metrics = await response.json();

Response

{
  "market": "ABC123...",
  "total_volume_usdc": 150000.00,
  "volume_24h_usdc": 5420.50,
  "volume_7d_usdc": 32100.00,
  "volume_by_option": {
    "0": 85000.00,
    "1": 65000.00
  },
  "num_trades": 1247
}

Interval Details

Interval	Description	Max History
`1m`	1 minute	60 points
`5m`	5 minutes	60 points
`15m`	15 minutes	60 points
`1h`	1 hour	60 points
`4h`	4 hours	60 points
`1d`	1 day	60 points

Data is gap-filled to ensure continuous series. Missing intervals use the last known values.

Overview

REST Endpoints

WebSocket

Data Models

Market History

Get Price History

Response

Response Fields

Get Volume Metrics

Response

Interval Details

​Get Price History

​Response

​Response Fields

​Get Volume Metrics

​Response

​Interval Details

Get Price History

Response

Response Fields

Get Volume Metrics

Response

Interval Details