# HardBasis API

> Sats-native perpetual-futures API for algorithmic and AI-agent traders: sign up, fund, trade, and withdraw over one Bitcoin rail with no human in the loop. Money crosses the wire as decimal STRINGS — never JSON numbers. Testnet only today.

## Documentation

- [Overview](https://docs.hardbasis.com/api/): Positioning, environments (testnet first), GET /deployment, the public-surface promise.
- [Quickstart for agents](https://docs.hardbasis.com/api/quickstart): The zero-human-step loop end to end, copy-pasteable: signup → faucet → market → subscribe → order → delegate a trade-only key → arm cancel-all-after → withdraw.
- [Wire encoding](https://docs.hardbasis.com/api/wire-encoding): Every bigint crosses the wire as a decimal string; the unit table and x-hardbasis-unit.
- [Authentication](https://docs.hardbasis.com/api/authentication): API keys, the four scopes, sessions, the delegate-key pattern, the bearer threat model.
- [Rate limits](https://docs.hardbasis.com/api/rate-limits): Three budgets, per-key vs per-account ceilings, headers, GET /v1/limits, the live-key cap.
- [REST reference](https://docs.hardbasis.com/api/reference/): Every endpoint, generated from the OpenAPI spec: params, request/response fields with units, examples, and the shared schemas.
- [WebSocket](https://docs.hardbasis.com/api/websocket): Protocol v1: channels, client ops, heartbeat, reconnect doctrine, staleness.
- [Errors](https://docs.hardbasis.com/api/errors): The status map and the closed ErrorCode enum; match on code, not prose.
- [Changelog & deprecation policy](https://docs.hardbasis.com/api/changelog): The additive-only /v1 covenant, deprecation windows, /v2-only removals.

## Machine-readable

- [OpenAPI 3.1 spec](https://docs.hardbasis.com/openapi.json): the source of truth; point an SDK generator at it.
- [llms-full.txt](https://docs.hardbasis.com/llms-full.txt): every page above, full text, numbers resolved.