Venue fees
How each venue's taker fee is calculated, and how to apply it to orderbook levels.
GET /venue-markets returns three fields describing the venue's taker fee for
each market. These fields are returned by GET /venue-markets only — the
embedded venueMarkets[] on /venue-events and matchedVenueMarkets[]
entries do not carry them.
| field | meaning |
|---|---|
feeRate | The venue's published taker rate. null = we do not have it. 0 = the venue charges nothing. |
feeExponent | 0 = flat fraction of notional. >= 1 = quadratic family. null when feeBasis is winnings. |
feeBasis | fill, fill_in_game_only, winnings, or exit — when the fee is charged. |
null never means free. It means we have not ingested a fee for that market and
you should fall back to your own table. A venue that genuinely charges nothing
returns 0.
What is and isn't included
These fields carry the venue's fee only, and only the taker side — every venue below charges makers nothing.
They do not include PE's own execution costs, such as the builder fee on
Polymarket. Those appear in
feeBreakdown on GET /orderbook/{venueMarketOutcomeId}/route, which is the authoritative
number for what a trade will actually cost. Use these fields to render indicative
fee-inclusive levels; use feeBreakdown to quote.
Applying the fee
feeBasis: "fill" with feeExponent >= 1
The fee per share is feeRate * (p * (1 - p))^feeExponent.
Polymarket bills buys on the pre-fee quantity (notional / p, not the shares
you receive), so for a buy the correct general form is:
fee / notional = feeRate * (p * (1 - p))^feeExponent / pAt feeExponent = 1, which is by far the common case, that collapses to the
price-linear form:
fee / notional = feeRate * (1 - p) # feeExponent = 1 ONLYRead feeExponent per market — do not assume it is always 1. There is at least
one live Polymarket market serving feeExponent = 2. Hardcoding the collapsed
form would under-charge it substantially.
For a sell, where you state the share count yourself, use the plain per-share form with no gross-up.
A market that charges nothing returns feeRate: 0 with feeExponent: 1 — the
exponent is an inert placeholder there, since a zero rate gives a zero fee at
any exponent.
feeBasis: "exit"
Charged only when a position closes. Opening a position is free.
- Selling shares:
fee = feeRate * qty * p, a flat fraction of notional (feeExponentis0). - Holding to settlement on the winning side: the venue keeps
feeRateof the $1 payout.
effective payout = 1 - feeRateOnly Hyperliquid works this way. Its rate is 0.0007 * (s + max(s, 1)), where s is the market deployer's fee scale (0–10), so 14 bps at scale 1 and up to 140 bps at scale 10. That is the base-tier rate: Hyperliquid's volume, staking and referral discounts lower what a given trader pays.
Buy route responses report fills[].settlementFee and an estimatedPayout net of those fees. Use that payout to compare routes and show the winning return; totalFilled remains the share count. Hyperliquid quantities are solved as whole shares, including in split routes. Settlement fees do not increase buy funding or bridge amounts.
An absent deployerFeeScale is treated as scale 0 (7 bps). If no usable rate is stored for a market, quotes price it at 140 bps until one is available.
Per-venue reference
| venue | feeBasis | feeRate | feeExponent | where the venue publishes it |
|---|---|---|---|---|
| polymarket | fill | per market, 0–0.25 | 1, occasionally 2 | Polymarket fees; per-market values from Gamma feeSchedule (= CLOB fd) |
| hyperliquid | exit | per market, 0.0007–0.014 | 0 | Hyperliquid fees; per-market scale from outcomeMeta — verified 2026-09-11 |