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

# spot

> Query normalized spot OHLCV and trade-flow data across four exchanges.

`spot` returns stored spot facts under Meridian's unified 13-column contract.

## Arguments

| Argument     | Type              | Required    | Description                                          |
| ------------ | ----------------- | ----------- | ---------------------------------------------------- |
| `exchanges`  | `string[]`        | Yes         | One or more of `binance`, `bybit`, `okx`, `coinbase` |
| `columns`    | `string[]`        | Yes         | Spot column names to return                          |
| `begin`      | timestamp         | Yes         | Inclusive start                                      |
| `end`        | timestamp         | Yes         | Exclusive end                                        |
| `resolution` | string or integer | No          | Defaults to `1m`                                     |
| `products`   | `string[]`        | Conditional | Products such as `BTCUSDT` or Coinbase `BTCUSD`      |
| `coins`      | `string[]`        | Conditional | Coins such as `BTC`, expanded for requested venues   |
| `include`    | object            | No          | Coverage, provenance, and column-metadata flags      |

Provide `products` or `coins`. Meridian rejects unbounded product scans.

## Example arguments

```json theme={null}
{
  "exchanges": ["binance", "bybit", "okx", "coinbase"],
  "coins": ["BTC"],
  "columns": [
    "open_price",
    "high_price",
    "low_price",
    "close_price",
    "dollar_volume",
    "buy_dollar_volume",
    "sell_dollar_volume"
  ],
  "begin": "2026-07-13T00:00:00Z",
  "end": "2026-07-13T06:00:00Z",
  "resolution": "1h",
  "include": {
    "coverage": true,
    "provenance": true,
    "column_metadata": true
  }
}
```

## Spot CVD

Calculate spot dollar CVD from `buy_dollar_volume - sell_dollar_volume`, cumulatively summed in timestamp order. Trade-count fields are not volume substitutes.

<Card title="Spot column catalog" icon="table-columns" href="/data/spot-columns">
  See all 13 spot columns.
</Card>