Drazill API Documentation

Trading fees are volume-based. Your tier is set by your 30-day rolling trading volume (in CAD); higher tiers pay lower fees, and the top tier earns a maker rebate (a negative maker fee — you are paid to provide liquidity). A maker adds resting liquidity to the book; a taker removes it.

Schedule

Rates are percentages of the traded notional (the engine divides by 100 internally — a 2.00 taker rate is 2%). This table is generated from FEE_TIERS in app/services/fee_service.py and drift-gated in CI.

Tier	30-day volume (CAD)	Maker	Taker
Bronze	≥ 0	1.00%	2.00%
Silver	≥ 1,000	0.80%	1.50%
Gold	≥ 10,000	0.50%	1.00%
Platinum	≥ 50,000	0.20%	0.50%
Diamond	≥ 250,000	−0.05% (rebate)	0.30%

At the Diamond tier the maker rate is negative — a rebate credited to makers who post liquidity.

How a rate is chosen

The tier table above is the base. A market or a category can carry its own schedule, and a promotional window can cap what either of them charges. The engine picks the most specific rule that applies, then applies the promotional stages last. This block is generated from the same constants the /fees endpoints serve, so it cannot drift from the engine.

#	Source	When it applies
1	`market_schedule`	An active fee schedule targeting this market, if one is in its effective window.
2	`category_schedule`	Otherwise an active fee schedule targeting the market’s category.
3	`global_override`	Otherwise the global maker/taker rates, when an admin has moved them off their registered defaults.
4	`mm_agreement`	Otherwise, on the maker side only, the contractual rate in your active designated market-maker agreement, if you have one.
5	`partner_schedule`	Otherwise the negotiated rate in the partner program your account is enrolled in, if any.
6	`tier`	Otherwise your volume tier. This and the market-maker agreement are the only paths that can produce a maker rebate (negative maker fee).

Applied after resolution, in this order — both can only ever reduce:

Stage	Effect
`promo_window`	A promotional fee window on the market or its category is applied last as a cap: fee = min(fee, window fee). It never increases a fee and never turns one into a larger rebate.
`fee_rebate`	A per-user fee-rebate entitlement then takes basis points off whatever fee remains, floored at zero. It never flips a fee’s sign.

Sign rules worth knowing: a per-market or per-category schedule is never negative, so an override replaces the Diamond maker rebate with a real (possibly zero) fee. A promotional window is applied as fee = min(fee, window fee) — it can bring a fee down to zero, but it never enlarges a rebate. A per-user fee-rebate entitlement then takes basis points off whatever remains, floored at zero.

Per-market and per-category schedules, and promotional windows, are feature-flagged. In an environment where they are off, GET /fees/schedule returns an empty resolution_order and every rate comes from the tier table above.

Scope today. Overrides and windows are resolved wherever the caller supplies market context — GET /fees/preview, the fee breakdown on a receipt, and the admin console. Order-book and AMM fills are still priced from the volume tier: the matching engine’s fee call sites do not yet pass the market they are filling. Until that lands, treat /fees/preview as authoritative for scheduled pricing and the execution receipt as authoritative for what a fill actually charged. This page will drop this warning when the two agree.

Previewing the fee for a specific trade

What will this trade cost? (auth optional)

curl "https://staging.drazill.com/api/v1/fees/preview?market_id=$MARKET_ID&quantity=100&price=0.40"

GET /fees/preview runs the resolver above and returns the effective maker_pct and taker_pct, the source that set them, any promotional window with its expiry, and — when you pass quantity and price — the estimated_fee on that notional, rounded exactly as the engine rounds it.

Authentication is optional and the response says which basis you got: authenticated uses your own tier and entitlements, anonymous_bronze_baseline quotes the entry tier. Rate limit: 120 requests/minute. Source: app/api/routes/fees.py.

Reading your fees over the API

Two public endpoints expose the schedule and your current standing:

Public schedule (no auth)

curl "https://staging.drazill.com/api/v1/fees/schedule"

Your tier (authenticated)

curl -H "X-API-Key: $DRAZILL_API_KEY" \
  "https://staging.drazill.com/api/v1/fees/my-tier"

GET /fees/schedule returns all tiers plus the current withdrawal fee percentage; GET /fees/my-tier returns your tier name, maker/taker rates, 30-day volume, and progress to the next tier. Source: app/api/routes/fees.py.

Quotes are authoritative

Before placing an order you can preview a fee-inclusive quote (preview_order_quote in the SDKs). The fee shown in the quote is the fee that will be charged, and the quote token binds it when you place the order — so the disclosed fee equals the charged fee. Fees round up to the cent in the platform’s favour (How pricing works); treat the quote and the execution receipt the API returns as the source of truth rather than recomputing fees client-side.

An admin can globally override the maker/taker rates; when an override is active it applies in place of the tiered rates above. The GET /fees/* endpoints always reflect the rates actually in effect.