Skip to main content

Documentation Index

Fetch the complete documentation index at: https://hypernode-docs.polynode.dev/llms.txt

Use this file to discover all available pages before exploring further.

Computes effective fee rates over the last 7 days from actual fills, and explains the cryptic fee_token values you’ll see in trade responses.

​
Endpoint

GET /v1/fee-schedule

​
Why use this

Hyperliquid records fee_token as USDH, +0, +1, etc. These look opaque. This endpoint resolves them: which side they apply to, what they mean, and what rates are actually being charged today.

​
Response

{
  "computed_window": "last 7 days",
  "pct_fills_with_fee": 0.011,
  "effective_rates_bps": {
    "base_fee": "0.058",
    "builder_fee": "0.058",
    "deployer_fee": "0.000"
  },
  "fee_tokens": [
    {
      "raw": "USDH",
      "label": "USDH",
      "description": "Stable HIP-4 collateral. Paid on sell-side fills.",
      "applies_to": "sell"
    },
    {
      "raw": "+0",
      "label": "Yes shares",
      "description": "Buy-side fee deducted from received YES outcome shares (currently 0% rate).",
      "applies_to": "buy"
    },
    {
      "raw": "+1",
      "label": "No shares",
      "description": "Buy-side fee deducted from received NO outcome shares (currently 0% rate).",
      "applies_to": "buy"
    }
  ],
  "explanation": {
    "sell_side": "Fee in USDH (HIP-4 collateral). Currently ~5 bps on takers, slightly less on makers.",
    "buy_side": "Fee in the received outcome shares (+N where N = side_index of bought coin). Currently 0 bps."
  }
}
FieldDescription
computed_windowPeriod over which effective rates are calculated
pct_fills_with_feeFraction of fills with non-zero fee — most are zero on HIP-4
effective_rates_bps.base_feeAggregate base fee rate in basis points
effective_rates_bps.builder_feeBuilder-routed fee rate
effective_rates_bps.deployer_feePer-outcome deployer fee (HIP-4 unique mechanic)
fee_tokensEach known fee token with full enrichment

​
Notes

  • HIP-4’s deployer fee mechanic exists in protocol but is currently 0 bps for all observed fills.
  • +N notation in HIP-4 refers to the spot token at index N. For HIP-4 fills, +0/+1 map to the outcome’s Yes/No shares received in a buy.