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

# History

> Configure historical snapshot tracking and playback features.

History configuration enables tracking orderbook snapshots for playback and analysis.

## Basic Configuration

```tsx theme={null}
import { Orderbook } from '@krono/kit'

export const App = () => {
  return (
    <Orderbook.Root
      config={{
        symbol: 'BTC/USD',
        historyEnabled: true,
        maxHistoryLength: 100
      }}
    >
      {/* Components */}
    </Orderbook.Root>
  )
}
```

## History Options

### historyEnabled

Enable historical snapshot tracking.

**Type:** `boolean`

**Default:** `false`

```tsx theme={null}
<Orderbook.Root
  config={{
    symbol: 'BTC/USD',
    historyEnabled: true
  }}
>
  {/* Components */}
</Orderbook.Root>
```

<Note>
  Enabling history increases memory usage proportional to `maxHistoryLength`.
</Note>

### maxHistoryLength

Maximum number of snapshots to retain.

**Type:** `number`

**Default:** `100`

```tsx theme={null}
<Orderbook.Root
  config={{
    symbol: 'BTC/USD',
    historyEnabled: true,
    maxHistoryLength: 50
  }}
>
  {/* Components */}
</Orderbook.Root>
```

| Snapshots | Memory Impact |
| --------- | ------------- |
| 10        | ≈ 50KB        |
| 50        | ≈ 250KB       |
| 100       | ≈ 500KB       |
| 1000      | ≈ 5MB         |

## Related

<CardGroup cols={2}>
  <Card title="Orderbook" icon="chart-candlestick" href="/docs/kit/configuration/orderbook">
    Configure the core orderbook behavior.
  </Card>

  <Card title="Performance" icon="gauge" href="/docs/kit/configuration/performance">
    Fine-tune update frequency with throttling and debouncing options.
  </Card>

  <Card title="Asset Pairs" icon="coins" href="/docs/kit/configuration/asset-pairs">
    Configure how trading pair metadata is fetched and cached. Required for auto-populating `tickSize`.
  </Card>

  <Card title="Overview" icon="cog" href="/docs/kit/configuration/overview">
    See all configuration options in one place with complete TypeScript types and defaults.
  </Card>
</CardGroup>