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

# Data Conventions

> Units, instrument IDs, and the wire-format conventions used across Joyride.

## Units

| Concept         | Unit                     | Example                     |
| --------------- | ------------------------ | --------------------------- |
| Prices          | USDC micros              | `5_500_000` = \$5.50        |
| Sizes           | Millicontracts           | `1000` = 1 contract         |
| Balances        | USDC micros              | `10_000_000_000` = \$10,000 |
| HTTP timestamps | Microseconds since epoch | `1709164800000000`          |
| Risk timestamps | Milliseconds since epoch | `1709164800000`             |

## Cost calculation

```text theme={null}
cost = price_micros * size_millicontracts / 1000
```

Example:

```text theme={null}
2_000_000 * 500 / 1000 = 1_000_000
```

That corresponds to buying 0.5 contracts at $2.00 for a total cost of $1.00.

## Instrument IDs

Joyride follows Deribit's linear options naming style:

```text theme={null}
{ASSET}_USDC-{DMMMYY}-{STRIKE}-{C|P}
```

Examples:

* `SOL_USDC-28FEB26-150-C`
* `BTC_USDC-28FEB26-100000-P`
* `ETH_USDC-28FEB26-3500-C`

## Contract sizes

| Asset | Contract size |
| ----- | ------------- |
| BTC   | 1 BTC         |
| ETH   | 1 ETH         |
| SOL   | 1 SOL         |

Minimum order size is `10` millicontracts, or `0.01` contracts.

## Trust-critical differences

A few surfaces intentionally use float USD values instead of micros:

* risk engine marks and Greeks
* settlement summaries
* some bulk ticker spot-price fields

When integrating, treat the exchange wire format as the source of truth for units. The SDK normalizes many of these differences for callers.