# Intention

## Docs

- [Asset IDs](https://docs.intention.xyz/api-reference/conventions/asset-ids.md): How Intention identifies assets and markets in API requests and responses.
- [Errors](https://docs.intention.xyz/api-reference/conventions/errors.md): The error model and error codes returned by the Intention API.
- [Nonces](https://docs.intention.xyz/api-reference/conventions/nonces.md): How Intention uses nonces to order, deduplicate, and replay-protect signed actions.
- [Notation](https://docs.intention.xyz/api-reference/conventions/notation.md): Field types, encoding, and naming conventions used throughout the Intention API.
- [Rate Limits](https://docs.intention.xyz/api-reference/conventions/rate-limits.md): How Intention enforces request and order rate limits at the API surface.
- [Signing](https://docs.intention.xyz/api-reference/conventions/signing.md): How signed actions and session credentials are constructed and verified by the Intention protocol.
- [Tick and Lot](https://docs.intention.xyz/api-reference/conventions/tick-lot.md): Tick size, lot size, and rounding rules for orders submitted through the Intention API.
- [Bridge Integration](https://docs.intention.xyz/api-reference/integration/bridge.md): Programmatic integration with the Intention bridge for deposits and withdrawals.
- [Builder Codes](https://docs.intention.xyz/api-reference/integration/builder-codes.md): Affiliate and integrator attribution via builder codes attached to signed actions.
- [Listing Hooks](https://docs.intention.xyz/api-reference/integration/listing-hooks.md): Lifecycle events emitted when markets are listed, modified, or delisted on Intention.
- [API Reference](https://docs.intention.xyz/api-reference/introduction.md): Overview of Intention's planned REST, WebSocket, and integration APIs for traders and builders.
- [Data Schemas](https://docs.intention.xyz/api-reference/nodes/data-schemas.md): Canonical schemas for the records exposed by Intention's nodes and historical-data archives.
- [Foundation Node](https://docs.intention.xyz/api-reference/nodes/foundation-node.md): Run a foundation node to consume the Verifiable Execution Stream directly from the protocol.
- [Exchange Endpoints](https://docs.intention.xyz/api-reference/rest/exchange.md): REST write endpoints for placing, modifying, cancelling, and batching orders.
- [Info Endpoints](https://docs.intention.xyz/api-reference/rest/info.md): REST read endpoints for markets, account state, positions, fills, and the order book.
- [Heartbeats](https://docs.intention.xyz/api-reference/websocket/heartbeats.md): Connection heartbeats and liveness signaling on the Intention WebSocket API.
- [Post Channel](https://docs.intention.xyz/api-reference/websocket/post.md): Low-latency order placement and cancellation over the WebSocket post channel.
- [Subscriptions](https://docs.intention.xyz/api-reference/websocket/subscriptions.md): WebSocket subscription channels for market data and account events.
- [Architecture at a Glance](https://docs.intention.xyz/architecture-glance.md): A five-minute orientation to Intention's three-layer stack, two core components, and four protocol-native guarantees.
- [Bridge](https://docs.intention.xyz/architecture/bridge.md): Cross-chain deposits and withdrawals mediated by Intention's own validator set under the same 2f+1 fault model as consensus.
- [The Intelligence Layer](https://docs.intention.xyz/architecture/intelligence-layer.md): The AI-agent surface of Intention — what the four protocol-native guarantees enable for autonomous liquidity, risk, semantic interpretation, and strategy execution.
- [IntentionBFT](https://docs.intention.xyz/architecture/intention-bft.md): HotStuff-family consensus extended with canonical sequencing, in-consensus price quorums, batch availability, and leader reputation.
- [IntentionKernel](https://docs.intention.xyz/architecture/intention-kernel.md): The deterministic state-transition kernel at the core of Intention — a closed-world execution layer for financial primitives.
- [Network Topology](https://docs.intention.xyz/architecture/network.md): Validator roles, batch dissemination in the Narwhal / Bullshark family, and client and indexer access paths.
- [Oracle and Price System](https://docs.intention.xyz/architecture/oracle.md): Validator-submitted prices, stake-weighted median with MAD outlier rejection, and in-consensus certification with a bounded error under the f < S/3 fault model.
- [Order-Time Determinism (G1)](https://docs.intention.xyz/architecture/otd.md): Replaying a committed block against the same pre-state produces byte-identical post-state, events, and per-transaction outputs.
- [Architecture Overview](https://docs.intention.xyz/architecture/overview.md): How Intention organizes assets, infrastructure, and intelligence into a single financial state machine.
- [Price-Transaction Atomicity (G2)](https://docs.intention.xyz/architecture/pta.md): The price a transaction uses for settlement was certified by a 2f+1 validator quorum in the same consensus event that committed the transaction.
- [Per-Transaction Attribution Discipline (G4)](https://docs.intention.xyz/architecture/ptad.md): Every state change and event is cryptographically bound to the transaction that caused it — even under batch matching — producing the Verifiable Execution Stream.
- [Risk-Native Semantics (G3)](https://docs.intention.xyz/architecture/rns.md): Risk is a protocol-level state machine running in the same atomic context as matching — not application code invoked by keepers.
- [Connect Wallet](https://docs.intention.xyz/get-started/connect-wallet.md): How traders will connect a wallet to Intention Exchange once mainnet is live.
- [Deposit and Bridge](https://docs.intention.xyz/get-started/deposit-bridge.md): How collateral will move onto Intention from external chains once the bridge is live.
- [Your First Trade](https://docs.intention.xyz/get-started/first-trade.md): What a first trade on Intention Exchange will look like once the public app is available.
- [Mobile](https://docs.intention.xyz/get-started/mobile.md): Planned mobile access to Intention Exchange, including QR-based wallet connect.
- [Testnet](https://docs.intention.xyz/get-started/testnet.md): How to access the planned Intention public testnet and request faucet funds.
- [Intention Labs](https://docs.intention.xyz/intention-labs.md): The core team building the Intention L1 and Intention Exchange, the flagship perpetual futures DEX on top of it.
- [Welcome to Intention](https://docs.intention.xyz/introduction.md): Intention is a Layer 1 blockchain for open markets, with native capabilities for AI agents built into the protocol.
- [FAQ](https://docs.intention.xyz/resources/faq.md): Frequently asked questions about Intention the L1 and Intention Exchange the flagship perpetual futures DEX — what they are, what you can trade, how custody works, and how to participate.
- [Glossary](https://docs.intention.xyz/resources/glossary.md): Definitions for the protocol, consensus, trading, and risk terms used throughout the Intention documentation.
- [Historical Data](https://docs.intention.xyz/resources/historical-data.md): Where Intention's historical trades, OHLCV, funding rates, and chain snapshots will be published.
- [A Manifesto](https://docs.intention.xyz/resources/manifesto.md): Why Intention exists, in the team's own voice. The arc from closed traditional markets, through broken general-purpose blockchains, to a Layer 1 built for the AI era of finance.
- [Risks](https://docs.intention.xyz/resources/risks.md): An honest disclosure of the protocol, market, oracle, bridge, and regulatory risks that traders take when using Intention.
- [Audits](https://docs.intention.xyz/risk-security/audits.md): Audit history and scope for Intention protocol, bridge, and trading engine.
- [Bug Bounty](https://docs.intention.xyz/risk-security/bug-bounty.md): Intention's coordinated-disclosure program for security researchers — scope, severity classification, reward ranges, rules of engagement, and how to submit a finding.
- [API and Integration Questions](https://docs.intention.xyz/support/api-questions.md): Where to take builder and integrator questions about the Intention API, protocol internals, and commercial integrations.
- [Deposit Not Credited](https://docs.intention.xyz/support/deposit-not-credited.md): What to do when a deposit is confirmed on the source chain but has not yet appeared in your Intention account.
- [Fill or PnL Question](https://docs.intention.xyz/support/fill-or-pnl-question.md): Understanding reported fill prices and PnL figures on Intention, and how to open a well-formed ticket if the numbers still look wrong.
- [Liquidation Question](https://docs.intention.xyz/support/liquidation-question.md): How Intention liquidations work, how to read the event that closed your position, and when a liquidation dispute is actually a support issue.
- [Lost Wallet Access](https://docs.intention.xyz/support/lost-access.md): What to do if you have lost access to the wallet associated with your Intention account, and why this is a wallet-level problem rather than a protocol-level one.
- [Mobile Pairing](https://docs.intention.xyz/support/mobile-pairing.md): Connecting a mobile wallet to Intention Exchange over a QR code, and what to do when pairing fails.
- [Order Rejected](https://docs.intention.xyz/support/order-rejected.md): The common reasons an order is rejected before reaching the book and the one-line remedy for each.
- [Support Overview](https://docs.intention.xyz/support/overview.md): How to reach the Intention team, what to include in a ticket, and the official surfaces we use to communicate.
- [Scam or Compromised Account](https://docs.intention.xyz/support/scam-or-hacked.md): Immediate steps if you believe you have been scammed or your account has been compromised, and what Intention Labs can and cannot do.
- [Session Signature](https://docs.intention.xyz/support/session-signature.md): What the Intention session signature grants, how to inspect and revoke it, and what happens when it expires.
- [Wallet Connection](https://docs.intention.xyz/support/wallet-connection.md): Troubleshooting the wallet-connect flow when Intention Exchange fails to pair with your wallet.
- [Withdrawal Pending](https://docs.intention.xyz/support/withdrawal-pending.md): Understanding the two-stage latency of a withdrawal and when to escalate if the destination has not received it.
- [Withdrawal to the Wrong Wallet](https://docs.intention.xyz/support/withdrawal-wrong-wallet.md): What to do when a withdrawal lands at an address or chain that cannot receive it.
- [Wrong Network or Wrong Asset](https://docs.intention.xyz/support/wrong-network-or-asset.md): What happens when funds are sent on an unsupported chain or in an unsupported asset, and when recovery is possible.
- [Add & Remove Margin](https://docs.intention.xyz/trading/add-margin.md): Isolated positions can receive additional margin manually or via automatic top-ups from free wallet balance to push their liquidation price away from danger.
- [Auto-Deleveraging (ADL)](https://docs.intention.xyz/trading/adl.md): ADL is Intention's final backstop: when the liquidation vault cannot absorb a position, counterpart profitable traders are closed at the bankruptcy price to guarantee solvency.
- [Trading Fees](https://docs.intention.xyz/trading/fees.md): Maker/taker fees on Intention use a 14-day rolling volume schedule with additional rebates for top market makers and group-based contract pricing.
- [Funding Rate](https://docs.intention.xyz/trading/funding.md): Funding is a peer-to-peer hourly payment between longs and shorts that keeps the perpetual price anchored to the underlying index.
- [Index Price](https://docs.intention.xyz/trading/index-price.md): Index price aggregates major spot venues with 24-hour volume weighting, deviation filtering, and failover to produce a manipulation-resistant fair value.
- [Leverage & Risk Limit Tiers](https://docs.intention.xyz/trading/leverage.md): Intention uses a risk-limit ladder: maximum leverage steps down as position notional grows, and maintenance margin steps up correspondingly.
- [Liquidations](https://docs.intention.xyz/trading/liquidations.md): Intention liquidates risky accounts in tiers — warnings, self-recovery, order-book clearing, vault takeover, and ADL — to protect solvency without socialized losses.
- [Margin Modes](https://docs.intention.xyz/trading/margin-modes.md): Intention supports isolated margin (per-position) and cross margin (account-wide), with one-way and hedge position modes on top.
- [Mark Price](https://docs.intention.xyz/trading/mark-price.md): Mark price is a manipulation-resistant fair-value estimate used to calculate unrealized PnL, trigger liquidations, and evaluate stop and take-profit orders.
- [Market-to-Limit Conversion](https://docs.intention.xyz/trading/market-to-limit.md): Intention converts every market order into a protective limit order before matching, bounding slippage and preventing account bankruptcy on fills.
- [Markets & Contract Specs](https://docs.intention.xyz/trading/markets.md): Every perpetual future on Intention is specified by symbol, contract size, tick size, lot size, minimum order, and a risk-limit ladder of maximum leverage.
- [Modifying Orders](https://docs.intention.xyz/trading/modify-orders.md): Intention supports in-place size reductions and cancel-and-replace price or size-up modifications with clear priority and failure semantics.
- [Open Interest Limits](https://docs.intention.xyz/trading/oi-limits.md): Per-user position limits bound how much of a single contract any one account can hold, using a dual mechanism of absolute cap and percentage of total OI.
- [Order Book & Matching](https://docs.intention.xyz/trading/order-book.md): Intention Exchange runs a full on-chain central limit order book with price-time priority and a strict per-block action ordering for fair, deterministic matching — implemented at the L1, not at the application layer.
- [Order Types](https://docs.intention.xyz/trading/order-types.md): Intention supports market, limit, stop, and take-profit orders with GTC/IOC/FOK time-in-force and post-only, reduce-only execution flags.
- [Trading Overview](https://docs.intention.xyz/trading/overview.md): Intention Exchange is the flagship perpetual futures DEX on the Intention L1 — a full suite of professional order types, risk controls, and liquidity infrastructure inheriting its guarantees from the protocol below it.
- [Rounding & Precision](https://docs.intention.xyz/trading/precision.md): Intention rounds risk-critical fields conservatively against the user and uses round-half-even for display and settlement, to fairly allocate precision error.
- [Quick Reverse](https://docs.intention.xyz/trading/quick-reverse.md): A one-click combination action that market-closes your current position and opens an equal-sized position in the opposite direction.
- [Reduce-Only Orders](https://docs.intention.xyz/trading/reduce-only.md): A reduce-only flag guarantees an order can only decrease an existing position — never increase it, never flip it, and never require fresh margin.
- [Scale Orders](https://docs.intention.xyz/trading/scale-orders.md): Scale orders lay a configurable ladder of limit orders across a price range, with optional size skew toward one end of the range.
- [Self-Trade Prevention](https://docs.intention.xyz/trading/self-trade-prevention.md): Intention's matching engine prevents any order from matching another order owned by the same account by cancelling the resting maker.
- [Take-Profit & Stop-Loss](https://docs.intention.xyz/trading/tp-sl.md): Attach TP and SL to new orders or to existing positions, with OCO linkage, market or limit triggers, and strict reduce-only semantics.
- [TWAP Orders](https://docs.intention.xyz/trading/twap.md): Time-weighted average price execution splits a large order into time-sliced child orders to reduce market impact, with catch-up and randomization.
- [Transaction Sequencing](https://docs.intention.xyz/trading/tx-sequencing.md): Every block applies user actions in a fixed priority order so traders and integrators can reason precisely about when their orders and cancels take effect.
- [Vaults](https://docs.intention.xyz/trading/vaults.md): Vaults let depositors share in liquidity-provision and strategy profits — either the protocol-owned liquidity vault or user-created strategy vaults with a leader.
- [DDoS and Sybil Defense](https://docs.intention.xyz/validators/ddos-defense.md): Network-edge and address-level protections that keep Intention responsive under attack.
- [Monitoring and Observability](https://docs.intention.xyz/validators/monitoring.md): Chain-layer monitoring for Intention validators: node resources, consensus, network, and business signals.
- [Running a Validator](https://docs.intention.xyz/validators/running.md): Operator-focused guide to installing, configuring, and running an Intention validator node.