Prerequisites
Before you begin, ensure you have:- A Busha Business Account and Secret API Key (from the Quick Start Tutorial).
-
An API key that carries the
exchange:read(orapi:read) scope. - A basic understanding of orders (from Placing and Managing Orders).
How to Check Fills and Fees
1
Check Your Fee Rates
Your effective rates are decimal fractions: Expected Response:Filter a single market with
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:?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 Expected Response:The key fields:
Filter by
maker or taker on that print.To list your fills:| Field | Description |
|---|---|
fill_id | The venue’s identifier for this execution. |
order_id / client_order_id | The order this execution belongs to, by platform ID and by your own reference. |
price / quantity / quote_quantity | The executed price and sizes. |
fee / fee_currency | The fee actually charged for this fill, in the market’s quote currency. |
liquidity | maker (your order was resting) or taker (your order crossed the spread). Fee rates differ by side. |
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.
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 Foundon fees: Themarketsymbol is unknown. Symbols areBASE-QUOTEand uppercase. -
503 Service Unavailableon 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
statuswithGET /v1/exchange/orders. -
401 Unauthorized: Your key lacks theexchange:read(orapi:read) scope.