> ## Documentation Index > Fetch the complete documentation index at: https://docs.hypedexer.com/llms.txt > Use this file to discover all available pages before exploring further. # Aggregated fees per user / coin / day > Returns fee aggregations grouped by user, coin, feeToken, and date. Only includes fills where `fee > 0`. - `total_fee_raw`: sum of fees in the original fee token - `total_fee_usdc`: sum of fees normalized to USD - `total_notional`: total traded volume (px * sz) in USD - `effective_rate`: fee / notional (multiply by 10000 for bps) ## OpenAPI ````yaml /api-reference/openapi-hip4.json get /hip4/fees openapi: 3.0.3 info: title: 'Hypedexer API: HIP-4 Prediction Markets' version: 1.0.0 description: >- API to query indexed HIP-4 prediction market data on Hyperliquid. HIP-4 introduces on-chain prediction markets (outcome trading). This API indexes: - **Outcomes**: Prediction market outcome definitions with Yes/No sides, volume stats, and question linkage - **Questions**: Groups of related outcomes (e.g. "What will Hypurr eat?" → Akami, Otoro, Canned Tuna) - **Fills**: All executed trades on prediction markets (`#` coins) and outcome spot tokens (`@` coins) - **Providers**: Per-provider trading stats for permissionless venues (plus the legacy `oracle`) - **Deployers**: The permissionless deployer registry (venues, fee scales, delegations) - **Fees**: Aggregated fee breakdown per user, coin, and day - **Settlements**: Market resolution events - **Outcome Tokens**: Spot token metadata for tradeable outcome assets - **Fee Scales**: Governance events for global outcome fee configuration - **User Actions**: On-chain user actions (Split, Merge, Negate outcomes) > ### Permissionless providers Since the permissionless-HIP4 network upgrade (2026-08-29), prediction markets can be deployed by third-party providers (a deployer address operating a named venue), not only by the Hyperliquid oracle. The API attributes every market, question and fill to its provider. Markets with no on-chain venue (pre-upgrade markets, and markets still emitted by the HL oracle pipeline) are reported under the reserved provider name `oracle` in aggregates: see [Permissionless providers and the oracle convention](/hip-4/overview#permissionless-providers-and-the-oracle-convention). ### Fee behavior - `#` prediction market fills currently have `fee = 0` (the `SetOutcomeFeeScale` governance action has not been activated) - `@` outcome token fills (spot) are charged normal spot fees (taker/maker rates) - `fee_usdc` is the fee normalized to USD equivalent ### Pagination All list endpoints support `limit` (default 100, max 10000; `/hip4/providers` and `/hip4/deployers`: max 1000) and `offset` (default 0). ### Time filters - `start` / `end` on fills: epoch **milliseconds** - `start` / `end` on `/hip4/providers`: **ISO datetime** - `start` / `end` on other endpoints: epoch **milliseconds** servers: - url: https://api.hypedexer.com description: Mainnet security: - X-API-Key: [] tags: - name: Analytics description: Time-bucketed prediction market analytics (volume, fills, fees, traders). - name: Providers description: Per-provider trading stats (permissionless venues + the legacy `oracle`). - name: Deployers description: Permissionless deployer registry (venues, fee scales, delegations). - name: Outcomes description: Prediction market outcome definitions and metadata. - name: Questions description: Prediction questions grouping multiple outcomes. - name: Fills description: Prediction market and outcome token fills. - name: Fees description: Aggregated fee analytics. - name: Settlements description: Market resolution events. - name: Outcome Tokens description: Spot token metadata for outcome assets. - name: Fee Scales description: Governance fee scale events. - name: User Actions description: On-chain user outcome actions. paths: /hip4/fees: get: tags: - Fees summary: Aggregated fees per user / coin / day description: >- Returns fee aggregations grouped by user, coin, feeToken, and date. Only includes fills where `fee > 0`. - `total_fee_raw`: sum of fees in the original fee token - `total_fee_usdc`: sum of fees normalized to USD - `total_notional`: total traded volume (px * sz) in USD - `effective_rate`: fee / notional (multiply by 10000 for bps) operationId: listFees parameters: - name: user in: query description: Filter by user wallet address schema: type: string - name: coin in: query description: Filter by coin schema: type: string - name: start in: query description: Start time (epoch milliseconds) schema: type: integer format: int64 - name: end in: query description: End time (epoch milliseconds) schema: type: integer format: int64 - name: limit in: query schema: type: integer default: 100 maximum: 10000 - name: offset in: query schema: type: integer default: 0 responses: '200': description: OK content: application/json: schema: type: array items: $ref: '#/components/schemas/FeeAggregation' example: - user: '0x1733d1945f023dfece04363d26f032ef069accdc' coin: '@10' feeToken: CHUTORO date: '2026-03-29' fills: 1 total_fee_raw: 0.01 total_fee_usdc: 0.006973 total_notional: 10.4595 effective_rate: 0.0006666666666666666 components: schemas: FeeAggregation: type: object properties: user: type: string description: Wallet address coin: type: string description: Coin feeToken: type: string description: Fee denomination token date: type: string format: date description: Date (YYYY-MM-DD) fills: type: integer description: Number of fills total_fee_raw: type: number description: Total fee in feeToken total_fee_usdc: type: number description: Total fee in USD total_notional: type: number description: Total notional volume in USD effective_rate: type: number description: Fee rate (fee_usdc / notional). Multiply by 10000 for bps. securitySchemes: X-API-Key: type: apiKey in: header name: X-API-Key description: 'Include in every request header as `X-API-Key: `.' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.