Reference

Fees

What a trade costs on the Taifoon CLOB, in full. There are two fee layers and nothing else — a trading fee in basis points, and the on-chain settlement gas, charged at cost. No hidden spreads, no withdrawal fees, no per-API surcharge. This page is rendered from the live fee schedule.

Note

The §2 ladder below is read from the live schedule (GET /book/v1/fees/schedule, version v1), revalidated every 5 minutes.

Two fee layers

Every fill is priced as two independent lines. Keeping them separate is the point: the venue never bundles its margin into the gas, and never marks up the gas.

Trading fee (bps). A basis-point fee on notional, set by your 30-day volume tier (§2). Takers pay; makers earn a rebate (a negative bps). Base tier: taker 4.00 bps (0.040%), maker -1.00 bps (-0.010%).
Settlement gas (USD). A flat $0.02 (settlement_gas_usd) charged at cost when a fill is written on chain. It is the network's price, not the venue's — see verify on chain.

§1 — Per-operation costs

What each operation costs. Trading bps apply only where notional changes hands; the rest cost only their on-chain footprint (and most cost nothing).

Operation	Trading fee	Settlement	Notes
place	free until filled	—	Resting an order is free; you pay on the fill.
fill (taker)	4.00 bps × notional	$0.02	Crosses the book; pays the taker bps for your tier.
fill (maker)	-1.00 bps rebate	$0.02	Rests then fills; earns the maker rebate.
cancel	free	free / at cost	Free if unsettled; settlement gas only if already on chain (§ below).
replace	free until filled	—	Cancel + place as one op; priced like its constituents.
reverse	taker bps × 2	2 × $0.02	Close + open opposite — two taker fills.
options structuring	1.00 bps	$0.02	On the structured notional, one-time at open.
liquidation penalty	50.00 bps	$0.02	Charged on the liquidated notional only if you are liquidated.

Cancel: free vs on-chain

A cancel is free while the order is still resting (the book never settled it). If any part of the order already filled and settled on chain, the cancel costs only the settlement gas to record the disposition — never a trading fee. The DELETE /book/v1/orders/{id} response tells you which happened via settled_onchain and settlement_usd.

§2 — Volume tier ladder

Your tier is set by trailing 30-day notional. Higher tiers pay a lower taker fee, earn a deeper maker rebate, and get a higher request rate limit. Query GET /book/v1/account/{addr}/volume?window=30d for your current tier, volume, and the notional to the next rung.

Tier	30d notional ≥	Taker	Maker	Rate / s	Perk
T0 Base	$0	4.00 bps	-1.00 bps	20	—
T1 Bronze	$250k	3.50 bps	-1.20 bps	30	priority match queue
T2 Silver	$1M	3.00 bps	-1.50 bps	50	reduced settlement batching latency
T3 Gold	$5M	2.50 bps	-1.80 bps	80	API rate-limit x2
T4 Platinum	$25M	2.00 bps	-2.00 bps	120	dedicated relayer lane
T5 VIP / Market Maker	$100M	1.50 bps	-2.50 bps	200	custom / negotiable

GET/book/v1/fees/schedule

REAL

The account-agnostic fee schedule that renders this page. Two layers + the tier ladder.

Response

Field	Type	Required	Description
version	string	no	Schedule version stamp.
options_structuring_bps	number	no	bps on structured option notional.
liquidation_penalty_bps	number	no	bps penalty on liquidated notional.
settlement_gas_usd	number	no	Flat on-chain settlement cost, at cost.
tiers[]	array	no	Tier rows: name, min_30d_notional_usd, taker_bps, maker_bps (signed), rate_limit_per_sec, perk.

Code

curl -s https://clob.taifoon.dev/book/v1/fees/schedule | jq

GET/book/v1/account/{addr}/volume?window=30d

REAL

Your placement on the ladder: 30-day notional, current tier, and the notional to the next rung.

Query parameters

Field	Type	Required	Description
window	string	no	Trailing window. "30d" today.

Response

Field	Type	Required	Description
address	string	no	The queried account.
notional_30d	number	no	Trailing-30d traded notional (USD).
fills_30d	number	no	Fill count over the window.
tier	string	no	Current tier name (matches a schedule row).
next_tier_at	number \| null	no	Notional to the next tier; null at the top.
pending_rebate_usd	number	no	Accrued maker rebate not yet settled.

Code

curl -s 'https://clob.taifoon.dev/book/v1/account/0xYOUR/volume?window=30d' | jq

Verify on chain

Every settled fill is written by the LogFill contract on chain 36927. The settlement gas you pay is exactly that transaction's network cost — you can read it yourself. Resolve the live contract addresses from the registry, then open any of them on the explorer.

GET/book/v1/onchain/addresses

REAL

Chain id, explorer base, and the deployed settlement contracts (incl. LogFill).

Response

Field	Type	Required	Description
chainId	number	no	36927.
explorer	string	no	Blockscout base URL.
contracts	object	no	Keyed by name (e.g. LogFill) → { address, explorer, ... }.

Code

curl -s https://clob.taifoon.dev/book/v1/onchain/addresses | jq '.contracts.LogFill'

Note

Block explorer: blockscout.taifoon.dev. Cross-check any fill's settlement against the on-chain LogFillevent — the venue cannot show you a number the chain doesn't.