Skip to main content

Units

ConceptUnitExample
PricesUSDC micros5_500_000 = $5.50
SizesMillicontracts1000 = 1 contract
BalancesUSDC micros10_000_000_000 = $10,000
HTTP timestampsMicroseconds since epoch1709164800000000
Risk timestampsMilliseconds since epoch1709164800000

Cost calculation

cost = price_micros * size_millicontracts / 1000
Example:
2_000_000 * 500 / 1000 = 1_000_000
That corresponds to buying 0.5 contracts at 2.00foratotalcostof2.00 for a total cost of 1.00.

Instrument IDs

Joyride follows Deribit’s linear options naming style:
{ASSET}_USDC-{DDMMMYY}-{STRIKE}-{C|P}
Examples:
  • SOL_USDC-28FEB26-150-C
  • BTC_USDC-28FEB26-100000-P
  • ETH_USDC-28FEB26-3500-C

Contract sizes

AssetContract size
BTC1 BTC
ETH1 ETH
SOL1 SOL
Minimum order size is 100 millicontracts, or 0.1 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.