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

# FundingPayment Schema

> One hourly funding settlement of one position of a wallet. Includes parameters, response shapes, examples, and implementation notes from the 0xArchive contract.

Source OpenAPI: 0xArchive API 1.13.0; 242 paths; 243 component schemas.

One hourly funding settlement of one position of a wallet.

## Required Fields

| Field | Type | Description |
| - | - | - |
| `coin` | string | Alias of `symbol`. |
| `direction` | string | `received` or `paid`, following the sign of `funding_amount`; `none` when the payment rounds to zero. |
| `funding_amount` | string | The wallet's funding cash flow in the market's collateral, 6 decimals: positive when received, negative when paid. |
| `funding_rate` | string | Hourly funding rate that settled, as a fraction (up to 10 decimals). |
| `position_size` | string | Signed position size at settlement, in base units. |
| `symbol` | string | Market symbol (HIP-3: `dex:COIN`). |
| `timestamp` | string:date-time | Settlement time (UTC). |

## JSON Schema

```json theme={"theme":"github-dark"}
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "FundingPayment",
  "description": "One hourly funding settlement of one position of a wallet.",
  "type": "object",
  "required": [
    "coin",
    "direction",
    "funding_amount",
    "funding_rate",
    "position_size",
    "symbol",
    "timestamp"
  ],
  "properties": {
    "block_number": {
      "description": "Hyperliquid block of the settlement. Omitted when unknown.",
      "type": "integer",
      "format": "int64",
      "example": 1206818191
    },
    "coin": {
      "description": "Alias of `symbol`.",
      "type": "string",
      "example": "BTC"
    },
    "dex": {
      "description": "HIP-3 only: dex of the market.",
      "type": "string",
      "example": "xyz"
    },
    "direction": {
      "description": "`received` or `paid`, following the sign of `funding_amount`; `none` when the payment rounds to zero.",
      "type": "string",
      "enum": [
        "received",
        "paid",
        "none"
      ],
      "example": "received"
    },
    "funding_amount": {
      "description": "The wallet's funding cash flow in the market's collateral, 6 decimals: positive when received, negative when paid.",
      "type": "string",
      "nullable": true,
      "example": "2225.541409"
    },
    "funding_rate": {
      "description": "Hourly funding rate that settled, as a fraction (up to 10 decimals).",
      "type": "string",
      "nullable": true,
      "example": "0.0000125"
    },
    "position_size": {
      "description": "Signed position size at settlement, in base units. Negative is short.",
      "type": "string",
      "nullable": true,
      "example": "-2319.60124"
    },
    "symbol": {
      "description": "Market symbol (HIP-3: `dex:COIN`).",
      "type": "string",
      "example": "BTC"
    },
    "timestamp": {
      "description": "Settlement time (UTC).",
      "type": "string",
      "format": "date-time",
      "example": "2026-11-06T00:00:00.025Z"
    }
  }
}
```

## Components using this schema

* [ApiResponseFundingPaymentArray](https://docs.0xarchive.io/schemas/components/api-response-funding-payment-array.md)

## Referenced By

Use this shared schema with the generated component index and route-specific endpoint pages during implementation.

## Operations using this component transitively

* [`GET /v1/hyperliquid/hip3/wallets/{address}/funding`](https://docs.0xarchive.io/schemas/operations/get-hip3-wallet-funding)
* [`GET /v1/hyperliquid/wallets/{address}/funding`](https://docs.0xarchive.io/schemas/operations/get-hyperliquid-wallet-funding)


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