> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devnet.perp.ordr.trade/llms.txt
> Use this file to discover all available pages before exploring further.

# Keywords

> Plain-English definitions for the trading and architecture terms used across these docs

A reference for terms used throughout these docs, from general perpetual
futures vocabulary to words specific to how perps.ordr is built. Each
heading is a jump target, so other pages can link straight to a definition.

## Trading basics

### Perpetual (perp)

A futures contract with no expiry date. It tracks an underlying asset's
price without ever requiring delivery of the asset itself, held open as
long as its margin covers it.

### Long

A position that profits when the price goes up: betting the asset will be
worth more later than its entry price.

### Short

A position that profits when the price goes down: betting the asset will be
worth less later than its entry price.

### Notional

The dollar value of a position's full exposure, `size × price`. A 2 SOL
position at $150 has $300 of notional, regardless of how much margin backs
it.

### Leverage

How much notional exposure one unit of margin controls. 5x leverage means
$1 of margin can back $5 of notional, see [Margin](#margin).

### Mark price

The price a market actually uses to value open positions and decide
funding, usually close to the midpoint of the best bid and ask rather than
the last traded price.

### Oracle price

An independent price feed (perps.ordr uses Pyth) that fills are bounded
against, so a thin or manipulated book can never produce a fill far from
the real market.

### Spot price

The current real-world price of the underlying asset, as opposed to the
price of the perpetual contract tracking it.

### Limit price

The worst price a trader is willing to accept on an order. A buy never
fills above it, a sell never fills below it.

### Taker

Whoever submits an order that waits to be matched against resting quotes,
as opposed to the maker who posted them. See
[Batching and Liquidations](https://docs.devnet.perp.ordr.trade/architecture/batching-and-liquidations.md).

### Maker

An approved market maker who posts the resting quotes a taker's order fills
against. See [The Shared Book](https://docs.devnet.perp.ordr.trade/architecture/shared-book.md).

## Margin and risk

### Margin

The collateral set aside to back a position, the amount that's actually at
risk rather than the full notional it controls.

### Isolated margin

Margin committed to one specific position. A loss on it can never spill
over and affect any other position.

### Cross margin

Margin shared across every open cross position in one account. One pool of
collateral backs them all together, so a gain on one can cover a loss on
another, see [Margin and Vaults](https://docs.devnet.perp.ordr.trade/architecture/margin-and-vaults.md).

### Initial margin requirement (IMR)

The minimum margin a position needs to be opened at all, set per market as
a fraction of notional.

### Maintenance margin requirement (MMR)

The minimum margin a position needs to stay open once it exists. It's
always lower than the initial requirement, so a position that just opened
isn't instantly at risk of liquidation.

### Equity

A position or account's margin, adjusted for its running unrealized profit
or loss. What's actually left to lose before liquidation.

### Liquidation

Force-closing a position, in part or in full, once its equity can no longer
cover its maintenance margin requirement.

### Liquidation price

The price at which a position's equity would fall exactly to its
maintenance requirement, the trigger for liquidation.

### Funding rate

A periodic payment between longs and shorts that pulls a perpetual's price
back toward the spot price it's meant to track, paid by whichever side the
market is leaning toward.

### Open interest (OI)

The total notional of all positions currently open on a market, long plus
short.

### PnL

Profit and loss. **Unrealized** PnL is what an open position would net if
closed right now; **realized** PnL is what a closed position actually paid
out.

## How perps.ordr is built

### Pool

One admin's on-chain account for one asset, holding every leverage tier
offered on it and every maker approved to quote on it. See
[Pools and Markets](https://docs.devnet.perp.ordr.trade/architecture/pools-and-markets.md).

### Market

One leverage tier of one pool, for example SOL at 5x, with its own book,
margin requirements, and open interest cap.

### Mid price

A maker's own reference price for a pool. Every one of that maker's resting
orders is priced as an offset from it, see
[The Shared Book](https://docs.devnet.perp.ordr.trade/architecture/shared-book.md).

### Offset

The signed number of ticks a resting order sits from its maker's mid price,
rather than an absolute price.

### Tick size

The smallest price step an order's offset can move in.

### Lot size

The smallest size increment an order can be placed or filled in.

### Shared book

The single order book a market's approved makers all quote into together,
as opposed to each maker holding a private book.

### Queue shard

One of 8 parallel slots a market's incoming taker orders wait in before a
batch clears them.

### Batch / `uncross`

The single instruction that clears a market's queued orders against its
makers' quotes at one price, at most once per slot. See
[Batching and Liquidations](https://docs.devnet.perp.ordr.trade/architecture/batching-and-liquidations.md).

### Crank

Whoever calls `uncross`, permissionlessly, to clear a market's batch.
Running it earns real fees, it isn't a privileged role.

### Clearing price

The single price every eligible order in a batch fills at, found by
matching cumulative maker supply against total taker demand.

### Liquidation heap

A market's own priority queue of open isolated positions, ordered by
liquidation price, checked every batch for anything that's crossed.

### Insurance fund

A market's reserve, funded by a small cut of every liquidation, that covers
a shortfall before a trader is left with an IOU.

### IOU

A promised payout a trader couldn't be paid in full right away because the
pool and insurance fund were both short. Claimable once the pool's balance
recovers.

### Vault (trader) vs. pool (maker)

A trader's vault holds only their own deposited funds. A maker's capital
instead sits inside their pool's one shared account, alongside every other
maker approved on that asset. See
[Margin and Vaults](https://docs.devnet.perp.ordr.trade/architecture/margin-and-vaults.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.