> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polynode.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Funding Rates

> Hourly funding-rate history, newest first. Window with `start_timestamp`/`end_timestamp` (Unix ms).

Newest first, one entry per hourly funding event, with `instrument_id`/`symbol` alongside the data.

## Query parameters

| Parameter                           | Description                                              |
| ----------------------------------- | -------------------------------------------------------- |
| `after` / `before`                  | Time window (Unix seconds or ms, detected automatically) |
| `limit`                             | Max rows (default 500, up to 5000)                       |
| `start_timestamp` / `end_timestamp` | Legacy aliases of `after` / `before` (Unix ms)           |

Responses carry a `more` flag; page older history by moving `before` to the oldest `timestamp` you've received.

The current live rate and the next funding time are on the [ticker](/perps/market-data/tickers). Rates are per funding interval (hourly) — multiply by 24×365 for an annualized figure.


## OpenAPI

````yaml GET /v3/perps/funding/{instrument}
openapi: 3.1.0
info:
  title: PolyNode API
  description: >-
    Real-time Polymarket data API with decoded mempool settlements, OHLCV
    candles, and full Polygon JSON-RPC proxy.
  contact:
    name: PolyNode
    url: https://polynode.dev
  license:
    name: ''
  version: 2.0.0
servers:
  - url: https://api.polynode.dev
    description: Production
security:
  - api_key: []
paths:
  /v3/perps/funding/{instrument}:
    get:
      tags:
        - Perps
      summary: Funding rates
      description: >-
        Hourly funding-rate history, newest first. Window with
        `start_timestamp`/`end_timestamp` (Unix ms).
      operationId: perps_funding
      parameters:
        - name: instrument
          in: path
          required: true
          description: Instrument id (e.g. `6`), symbol (`BTC-USD`), or bare asset (`btc`).
          schema:
            type: string
        - name: start_timestamp
          in: query
          required: false
          description: Window start, Unix ms (legacy alias of `after`).
          schema:
            type: integer
        - name: end_timestamp
          in: query
          required: false
          description: Window end, Unix ms (legacy alias of `before`).
          schema:
            type: integer
        - name: after
          in: query
          required: false
          description: >-
            Only rows after this time (Unix seconds or ms). Alias of
            start_timestamp.
          schema:
            type: string
        - name: before
          in: query
          required: false
          description: >-
            Only rows before this time (Unix seconds or ms). Alias of
            end_timestamp.
          schema:
            type: string
        - name: limit
          in: query
          required: false
          description: Max rows to return (default 500, up to 5000).
          schema:
            type: integer
      responses:
        '200':
          description: Success
          content:
            application/json:
              example:
                data:
                  - funding_rate: '0.0000125'
                    timestamp: 1783738800083
                  - funding_rate: '0.0000125'
                    timestamp: 1783735200089
                  - funding_rate: '0.0000125'
                    timestamp: 1783731600025
                instrument_id: 6
                more: true
                symbol: BTC-USD
components:
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: x-api-key

````