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

# Funding paid and received

> Funding paid and received by longs and shorts per UTC hour, across all markets or in one market.



## OpenAPI

````yaml /data-api/openapi.json get /v1/markets/funding/flows
openapi: 3.1.0
info:
  title: Hyperdash Data API
  version: v1
  description: >-
    Hyperliquid data from Hyperdash's own nodes and stored datasets; requests
    never call Hyperliquid's public API. Every response reports the credits it
    cost.
servers:
  - url: https://data.hyperdash.com
security: []
tags:
  - name: Accounts
  - name: Async jobs
  - name: Builders
  - name: Cohorts
  - name: HIP-3 dexes
  - name: Leaderboards
  - name: Lending
  - name: Liquidations
  - name: Markets
  - name: 'Markets: analytics'
  - name: 'Markets: funding'
  - name: 'Markets: liquidation and stop levels'
  - name: 'Markets: open interest and positioning'
  - name: 'Markets: order book'
  - name: 'Markets: prices and candles'
  - name: 'Markets: queue priority'
  - name: 'Markets: trades and flow'
  - name: 'Markets: TWAPs'
  - name: Network
  - name: Outcomes
  - name: Positions
  - name: Referrals
  - name: Snapshots
  - name: Spot
  - name: Staking
  - name: Traders
  - name: Vaults
paths:
  /v1/markets/funding/flows:
    get:
      tags:
        - 'Markets: funding'
      summary: Funding paid and received
      description: >-
        Funding paid and received by longs and shorts per UTC hour, across all
        markets or in one market. Each row also has payments and the exact
        number of paying and earning wallets.


        **How it works**

        - Each UTC hour is one settlement. Sum hours to get days.

        - Sums are exact and returned as decimal strings.


        **Fields**

        - `meta.as_of` is the exclusive end of the data.

        - `meta.start_time` and `meta.end_time` are the window actually covered.


        **Credits:** 360 per request. Range multiplier: ×1 to 1 day, ×6 to 25
        hours.


        **Scope:** `markets:read`
      operationId: getFundingFlows
      parameters:
        - name: coin
          in: query
          required: false
          description: One market. Leave it out for all markets.
          schema:
            type: string
        - name: start_time
          in: query
          required: false
          description: >-
            Start time in epoch milliseconds, inclusive. Defaults to 1 day
            before `end_time`. The range is at most 1 day and is snapped outward
            to whole hours.
          schema:
            type: integer
        - name: end_time
          in: query
          required: false
          description: >-
            End time in epoch milliseconds, exclusive. Defaults to now. It is
            clamped to the data, shown in `meta.as_of`.
          schema:
            type: integer
      responses:
        '200':
          description: OK
          headers:
            X-Credits-Charged:
              schema:
                type: integer
            X-Credit-Price-Version:
              schema:
                type: integer
            X-Request-Id:
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - has_more
                  - next_cursor
                  - meta
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        t:
                          type: integer
                          description: >-
                            Bucket start, a UTC hour or day, in epoch
                            milliseconds.
                        side:
                          type: string
                          description: '`long` or `short`.'
                        paid:
                          type: string
                          description: Funding paid, in USD. Decimal string.
                        received:
                          type: string
                          description: Funding received, in USD. Decimal string.
                        payments:
                          type: integer
                          description: Funding payments.
                        payers:
                          type: integer
                          description: Wallets that paid.
                        earners:
                          type: integer
                          description: Wallets that received.
                    description: Result rows.
                  has_more:
                    type: boolean
                    description: '`true` when another page follows.'
                  next_cursor:
                    type:
                      - string
                      - 'null'
                    description: >-
                      Cursor for the next page, passed as `cursor`. `null` on
                      the last page.
                  meta:
                    type: object
                    description: >-
                      Response metadata. Its keys depend on the endpoint and are
                      described above.
        '400':
          description: 'Invalid parameter (also: a request body that is not valid JSON)'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '401':
          description: Invalid, expired or revoked key
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '403':
          description: Scope, plan, history or credit limit
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '409':
          description: Price version changed, or a cursor's snapshot expired
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '429':
          description: >-
            Rate limited (Retry-After; free): request rate, concurrent requests
            (a request counts one slot per 1,000 rows it can return), or this
            server busy with your workspace's requests
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '502':
          description: Upstream data source failed (free; retry later)
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '503':
          description: Backend at capacity or temporarily unavailable (Retry-After)
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '504':
          description: Upstream data source timed out (free; retry later)
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      security:
        - bearer: []
      x-codeSamples:
        - lang: curl
          source: >-
            curl -H "Authorization: Bearer $HYPERDASH_API_KEY"
            'https://data.hyperdash.com/v1/markets/funding/flows'
components:
  schemas:
    Problem:
      type: object
      required:
        - type
        - title
        - status
        - code
        - request_id
      properties:
        type:
          type: string
        title:
          type: string
        status:
          type: integer
        code:
          type: string
        detail:
          type: string
        hint:
          type: string
        request_id:
          type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: Your API key, sent as `Bearer hdk_sk_live_v1_…`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.