Skip to main content
MetaFlux — derivatives, on first principles

MetaFlux Knowledge Base

Welcome. Start here if you are integrating with or building on MetaFlux.

info

New? Start with the Quickstart (5 minutes, deposit → trade → withdraw). Migrating from another perps DEX? Jump to Migrating from HL — switch your bot to the MTF-native SDK / API. Building on-chain? See MIP-3 permissionless market deploy.

Explore​

  • Architecture — a one-page map of the MetaFlux Core components and what each does
  • API reference — REST /exchange · /info, WebSocket, errors, rate limits
  • Concepts — margin, tiered liquidation, order types, funding, vaults, fees
  • Integration — quickstart, signing, idempotency, error handling, SDKs
  • EVM — execution model, Core ↔ EVM transfers, precompiles
  • Improvement proposals — spot/perp deploy, metaliquidity, earn
  • Bridge — validator-signed asset bridging

The left sidebar is the exhaustive index; the cards above are the fast way in.

Conventions​

  • Endpoints documented here are the stable, public wire surface.
  • Request / response examples use real shapes — copy-paste safe.
  • Price and size fields are fixed-point integers (8-decimal scale); USDC amounts are 6-decimal base units. Both are transmitted as JSON strings to avoid IEEE-754 precision loss.
  • All times in _ts / _ms fields are unix milliseconds (consensus-derived).

Status legend​

Each doc carries a "Status" tag at the top:

  • stable — wire shape committed for V1; safe to build against.
  • preview — works today; minor wire changes possible before mainnet (called out).
  • planned — described, not yet shipped.

See versioning for the change-control policy.