> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orica.markets/llms.txt
> Use this file to discover all available pages before exploring further.

# Market History

> Fetch historical price and volume data for markets.

## Get Price History

Retrieve historical price snapshots for charting and analysis.

```
GET /markets/{market_address}/history
```

**market\_address** `string` *required*

The market address.

**interval** `string` (default: 1h)

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

**limit** `integer` (default: 100)

Number of data points to return (max 1000).

```bash cURL theme={"dark"}
curl "https://api.orica.markets/markets/ABC123.../history?interval=1h&limit=24"
```

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

### Response

```json theme={"dark"}
[
  {
    "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

**timestamp** `number`

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

**market\_caps** `number[]`

Market cap for each outcome in USDC.

**supplies** `number[]`

Share supply for each outcome.

**volume** `number`

Cumulative volume in USDC at this point.

***

## Get Volume Metrics

Retrieve aggregate volume statistics for a market.

```
GET /markets/{market_address}/volume
```

```bash cURL theme={"dark"}
curl "https://api.orica.markets/markets/ABC123.../volume"
```

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

### Response

```json theme={"dark"}
{
  "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 |

> [!NOTE]
>
> Data is gap-filled to ensure continuous series. Missing intervals use the last known values.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.