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

# Get apiv1marketpairs funding

> Funding state for a perp market.



## OpenAPI

````yaml /proto-openapi/api/openapi.yaml get /api/v1/market/pairs/{tradingPairId}/funding
openapi: 3.0.3
info:
  title: Monaco Protocol API
  description: REST API for the Monaco Protocol hybrid CLOB exchange.
  version: 1.0.0
servers:
  - url: https://staging.apimonaco.xyz
    description: Staging server (Testnet)
security: []
tags:
  - name: AccountsService
  - name: ApplicationsService
  - name: AuthService
  - name: BuildercodeRewardsService
  - name: CopyTradingService
  - name: DelegatedAgentsService
  - name: FaucetService
  - name: FeesService
  - name: HealthService
  - name: ManagedMarketsService
    description: |-
      Wallet-authenticated maker assignments. The signed session must match both
       configured maker user and application. Owner IDs are process fences, never auth.
       Only wallet sessions are supported; delegated-agent sessions receive 403.
  - name: MarginAccountsService
    description: |-
      Current public isolated-margin semantics:
       - a user has one parent margin account per application scope
       - opening orders create or reuse isolated position buckets under that parent
       - parent account creation is handled internally by margin workflows
  - name: MarketService
  - name: OrderbookService
  - name: OrdersService
  - name: PositionsService
    description: |-
      Current public isolated-margin semantics:
       - positions link to a parent margin account and, when applicable, a bucket id
       - opening orders create or reuse isolated position buckets under the parent
       - users can open another isolated position by reusing the parent account with a different market bucket
  - name: PulseService
  - name: SweeperService
  - name: TraderCodeService
  - name: TradesService
  - name: WhitelistService
  - name: WithdrawalsService
paths:
  /api/v1/market/pairs/{tradingPairId}/funding:
    get:
      tags:
        - MarketService
      description: Funding state for a perp market.
      operationId: get_funding_state
      parameters:
        - name: tradingPairId
          in: path
          required: true
          schema:
            type: string
            default: 893d2add-2f36-4ee7-b660-893d2add2f36
          example: 893d2add-2f36-4ee7-b660-893d2add2f36
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetFundingStateResponse'
components:
  schemas:
    GetFundingStateResponse:
      type: object
      properties:
        tradingPairId:
          type: string
          nullable: true
          format: uuid
        currentFundingRate:
          example: '0.0001'
          type: string
          description: >-
            Most recently SETTLED funding rate as a decimal-string fraction per
            funding interval; "0" when nothing has settled yet
          nullable: true
        estimatedNextFundingRate:
          example: '0.00012'
          type: string
          description: >-
            Implied rate for the in-progress window. An estimate refreshed on
            each accepted premium sample (roughly every sample interval plus
            persistence lag), not a real-time stream; absent when the window has
            no samples. A window that ends with too few accepted samples settles
            at the previous settled rate instead (0 for a market that has never
            settled one), so the settled rate can differ from this estimate
          nullable: true
        nextFundingTime:
          example: '1754006400000'
          type: string
          description: >-
            Scheduled end of the current funding window (ms epoch string),
            always after the response time: once a window's end passes, this is
            the following boundary, even before the new window's first sample is
            recorded. An estimate, not a guarantee: settlement lands at or
            shortly after this boundary when the market is alive, and boundaries
            that pass while the engine is down are skipped, never settled
            retroactively
          nullable: true
        fundingIntervalSeconds:
          example: 3600
          type: integer
          description: >-
            Length of a funding window in seconds, inferred from settlement
            history and market configuration
          format: uint32
          nullable: true
        lastFundingTime:
          example: '1754002800000'
          type: string
          description: >-
            Close of the most recently settled window (ms epoch string); absent
            before the first settlement
          nullable: true
        updatedAt:
          type: string
          nullable: true

````

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