Skip to main content
This guide will walk you through two things every exchange trader needs: your fee rates (what you pay to trade) and your fills (what your orders actually executed). A fill records one execution against one of your orders, including the fee actually charged and whether you were the maker or taker.
What You’ll Achieve:
  1. Retrieve your effective maker and taker fee rates.
  2. List your fills and understand each field.
  3. Know how maker versus taker fees apply.

Prerequisites

Before you begin, ensure you have:

How to Check Fills and Fees

1

Check Your Fee Rates

Your effective rates are decimal fractions: 0.002 means 0.2%, and a negative maker rate is a rebate. Fees settle in the market’s quote currency.To list your fee rates:
Expected Response:
Filter a single market with ?market=USDT-NGN. Omit market for every listed market that accepts new orders, in symbol order.
These are your saved rates (or the entry tier). Terms can change before you place an order — the rate snapshot accepted on the order governs its executions, and GET /v1/exchange/fills reports what was actually charged.
2

List Your Fills

A fill is one execution against one of your orders. An order that traded in five prints has five fills, each with the fee actually charged and whether you were the maker or taker on that print.To list your fills:
Expected Response:
The key fields:
FieldDescription
fill_idThe venue’s identifier for this execution.
order_id / client_order_idThe order this execution belongs to, by platform ID and by your own reference.
price / quantity / quote_quantityThe executed price and sizes.
fee / fee_currencyThe fee actually charged for this fill, in the market’s quote currency.
liquiditymaker (your order was resting) or taker (your order crossed the spread). Fee rates differ by side.
Filter by market or order_id, and bound the window with from and to (execution time). limit defaults to 50 and is capped at 200.
3

Understand Maker vs. Taker

Whether a fill is maker or taker determines its fee rate:
  • Maker — your order rested in the book and added liquidity. You typically pay the lower rate (and may earn a rebate if the maker rate is negative).
  • Taker — your order crossed the spread to match a resting order, removing liquidity. You pay the taker rate.
In the fee example above, the maker rate is 0 (no fee) while the taker rate is 0.002 (0.2%). A fill with liquidity: maker therefore charged fee: "0.00".For real-time private updates on your orders and balances, mint a stream token with POST /v1/exchange/stream_tokens and subscribe over the exchange stream.

Troubleshooting Common Issues

  • 404 Not Found on fees: The market symbol is unknown. Symbols are BASE-QUOTE and uppercase.
  • 503 Service Unavailable on fees: A requested market has unusable fee terms. The endpoint never substitutes zero rates — retry or contact support.
  • Empty fills: Your orders may not have executed, or your filter window excludes them. Check order status with GET /v1/exchange/orders.
  • 401 Unauthorized: Your key lacks the exchange:read (or api:read) scope.

What’s Next?

Now that you understand fills and fees, you have the full exchange flow: