# DerivaDEX Docs

## Getting Started

- [DerivaDEX Docs](https://docs.derivadex.com/index.md): Start from the current DerivaDEX public docs surface.
- [What Is DerivaDEX?](https://docs.derivadex.com/getting-started/what-is-derivadex.md): Learn the exchange model, custody posture, governance role, and regulatory context.

## Tutorials

- [Tutorials](https://docs.derivadex.com/tutorials/index.md): Guided first-success workflows for trading and API integration.
- [Your First Trade on DerivaDEX](https://docs.derivadex.com/tutorials/your-first-trade-on-derivadex.md): Connect a wallet, deposit collateral, and place a first trade.
- [Your First API Trade on DerivaDEX](https://docs.derivadex.com/tutorials/your-first-api-trade-on-derivadex.md): Prepare signed and encrypted API request flow for a first DerivaDEX trading integration.

## How-To Guides

- [How-to Guides](https://docs.derivadex.com/how-to-guides/index.md): Task-focused guides for signing and encrypting DerivaDEX API requests.
- [How to Sign DerivaDEX Requests with EIP-712](https://docs.derivadex.com/how-to-guides/sign-requests-with-eip712.md): Build the typed-data hash and wallet signature for private request submission.
- [How to Encrypt Requests for the Operator](https://docs.derivadex.com/how-to-guides/encrypt-operator-requests.md): Encrypt signed request payloads before sending private trading requests.

## Reference

- [Reference](https://docs.derivadex.com/reference-public/index.md): Core factual reference for limits, lifecycle semantics, pricing, risk, and safety.
- [Product and Trading Specifications](https://docs.derivadex.com/reference-public/product-and-trading-specifications.md): Product model, trading constraints, and market-spec values.
- [Margin Requirements](https://docs.derivadex.com/reference-public/margin-requirements.md): Core margin invariants, factors, and liquidation-entry thresholds.
- [Price Feeds and Mark Price Inputs](https://docs.derivadex.com/reference-public/price-feeds-and-mark-price-inputs.md): Mark-price input and price-feed behavior.
- [Funding Rate Logic](https://docs.derivadex.com/reference-public/funding-rate-logic.md): Funding-rate calculation, clamp behavior, and settlement effect.
- [PnL Realization and Settlement](https://docs.derivadex.com/reference-public/pnl-realization-and-settlement.md): Realized/unrealized PnL and settlement behavior.
- [Rate Limits and Access Tiers](https://docs.derivadex.com/reference-public/rate-limits-and-access-tiers.md): Public rate-limit posture, tranche logic, and access-tier behavior.
- [Trade Mining Parameters](https://docs.derivadex.com/reference-public/trade-mining-parameters.md): Trade-mining reference parameters.
- [Trading Safeties and Guards](https://docs.derivadex.com/reference-public/trading-safeties-and-guards.md): Pre-trade validation, matching behavior, execution safeguards, liquidation, and ADL guarantees.
- [Error Reference](https://docs.derivadex.com/reference-public/error-reference.md): Public error semantics.
- [Order and Account Event Reference](https://docs.derivadex.com/reference-public/order-and-account-event-reference.md): Order, strategy, and trader event semantics.

## API Reference

- [API Reference](https://docs.derivadex.com/api-reference/index.md): Choose REST for request-response calls or the Realtime WebSocket API for live streams.
- [REST API](https://docs.derivadex.com/api-reference/rest.md): REST endpoint catalog for system, market, trade, and signed private-request paths.
- [Signed Private Requests](https://docs.derivadex.com/api-reference/rest/signed-requests.md): Private request envelopes, intent fields, delegated sessions, receipts, and errors.
- [Realtime Channels](https://docs.derivadex.com/api-reference/realtime/channels.md): Public WebSocket channels for subscription control, market data, and user-data updates.

## Explanations

- [How DerivaDEX Works](https://docs.derivadex.com/explanations/how-derivadex-works.md): High-level system model for request handling, settlement boundaries, and exchange mechanics.
- [Why DerivaDEX Is Architected Differently](https://docs.derivadex.com/explanations/why-derivadex-is-architected-differently.md): Architecture rationale and trade-offs.
- [Token Economy and Incentive Design](https://docs.derivadex.com/explanations/token-economy-and-incentive-design.md): DDX token and incentive model context.

## OpenAPI Specs

- [public-rest-unified](https://docs.derivadex.com/api-specs/public-rest-unified.json): OpenAPI specification for the public REST API.

## AsyncAPI Specs

- [realtime-server-asyncapi](https://docs.derivadex.com/api-specs/realtime-server-asyncapi.yaml): AsyncAPI specification for the public Realtime API.