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

# Get Options Exchange OI History

Get historical options open interest data across exchanges over time. Returns timestamped OI values for each exchange with corresponding price data. Supports USD or coin unit. Ideal for: OI trend analysis, exchange flow tracking, market structure analysis, historical comparisons.

![Get Options Exchange OI History logo](https://ai-icon.b3.fun/logo/coinglass)
Catalog action Blockchain Data

Get historical options open interest data across exchanges over time. Returns timestamped OI values for each exchange with corresponding price data. Supports USD or coin unit. Ideal for: OI trend analysis, exchange flow tracking, market structure analysis, historical comparisons.


## At a Glance

| Field | Value |
| --- | --- |
| Action ID | `coinglass-options-get-exchange-oi-history` |
| Category | Blockchain Data |
| Connector | Not required |
| Requires gas | No |
| Funds movement | None declared |
| Tags | `coinglass`, `options`, `open-interest`, `history`, `exchange`, `read` |

## Payload Schema

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | `string` | Yes | Coin symbol \(e.g., 'BTC', 'ETH'\) |
| `range` | `string` | Yes | Time range for historical data \(e.g., 'all', '1y', '6m', '3m', '1m'\) |
| `unit` | `string` | Yes | Unit for open interest values \(e.g., 'USD' or coin symbol like 'BTC'\) |

## Result Schema

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | `string` | Yes | Coin symbol |
| `range` | `string` | Yes | Time range used |
| `unit` | `string` | Yes | Unit for OI values |
| `exchanges` | `array` | Yes | List of exchanges with data |
| `dataPoints` | `array` | Yes | Array of historical data points |

## Examples

**Workflow node**

```json
{
  "type": "coinglass-options-get-exchange-oi-history",
  "payload": {
    "symbol": "ETH",
    "range": "all",
    "unit": "USD"
  },
  "children": []
}
```
  **Test with API**

```bash
curl -X POST "https://api.b3os.org/v1/actions/coinglass-options-get-exchange-oi-history/test" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "inputs": {
    "symbol": "ETH",
    "range": "all",
    "unit": "USD"
  }
}'
```

**Use expressions for dynamic values**

Payload fields can use workflow expressions such as `{{$trigger.body.amount}}`, `{{$nodes.fetch.result.price}}`, and `{{$props.asset}}` when the value should come from a trigger, prior node, or reusable workflow prop.