Skip to main content
The Info endpoints are the read side of the Intention REST API. They expose market metadata, live and historical account state, positions, fills, and order book snapshots. This page will document each endpoint, its parameters, its response shape, and its rate-limit category.
Status: not yet published. The Info endpoints will be released alongside the public testnet. Until then, treat the descriptions below as planning documentation.

​
What this page will contain

When the API ships, this page will list:
  • Markets. Discovery endpoint returning every active market, its tick size, lot size, leverage tiers, fees, and listing metadata.
  • Account state. Current collateral, margin usage, equity, and available buying power.
  • Positions. Open positions with size, entry price, mark price, unrealized P&L, and liquidation level.
  • Fills. Historical fills for an account, with the originating transaction hash for PTAD attribution.
  • Order book. Top-of-book snapshots and depth at configurable levels, with timestamps anchored to block height.
  • Funding history. Per-market funding rates and per-account funding payments.

​
Conventions

Read the conventions section first — notation, asset IDs, tick and lot, nonces, signing (only required for account-scoped reads), rate limits, and errors apply to every endpoint here. For early integration questions, email contact@intention.xyz.