# Funding Payments ## OpenAPI Specification ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /account/futures/funding-payments: get: summary: Funding Payments deprecated: false description: >- Returns a paginated list of funding payments, grouped by instrument code and sorted in descending order by timestamp. If no instrument code is provided, funding payments are fetched for all markets. Default Behavior for `from` and `to` parameters | Parameters Provided | Behavior | |-------------------|----------| | **Neither `from` nor `to`** | Returns last 7 days from UTC midnight to current time | | **Only `from`** | Returns 7 days starting from the provided `from` date | | **Only `to`** | Returns 7 days ending at the provided `to` date (starting from UTC midnight 7 days prior) | | **Both `from` and `to`** | Returns funding payments within the specified date range (max 90 days) | ### Parameter Specification | Parameter | Accepted Formats | Example Values | |-----------------|----------------|----------------| | `from` | ISO 8601 | `2025-09-25T13:45:30Z` (s), `2025-09-25T13:45:30.123Z` (ms), `2025-09-25T13:45:30.123456Z` (us) | | | Epoch | `1695647130` (s), `1695647130123` (ms), `1695647130123456` (us) | | | Date | `2025-09-25` | | `to` | ISO 8601 | `2025-09-26T18:00:00Z` (s), `2025-09-26T18:00:00.456Z` (ms), `2025-09-26T18:00:00.456789Z` (us) | | | Epoch | `1695734400` (s), `1695734400456` (ms), `1695734400456789` (us) | | | Date | `2025-09-26` | | `instrument_code` | String | `BTC_EUR_P` (single) | | | List | `BTC_EUR_P,ETH_EUR_P` (comma-separated list) | | `max_page_size` | Integer | `3` | | `cursor` | String | `eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...` | ### Parameter Limits | Parameter | Constraints / Range | |------------------|-------------------| | `from` | Date between **2024-01-01** and **present** | | `to` | Date **not earlier than** `from`; the period between `from` and `to` **must not exceed 30 days** | | `max_page_size` | Integer between **0** and **10** | | `instrument_code`| Optional; must be valid market code(s) | | `cursor` | Optional; string returned by previous response | ### Parameter Defaults | Parameter(s) | Default Behavior | |-----------------|-----------------| | `from` / `to` | Neither provided: `from` = 7 days ago at midnight UTC, `to` = present time | | `from` / `to` | Only `from` provided: `to` = 7 days later or present time, whichever is smaller | | `from` / `to` | Only `to` provided: `from` = 7 days earlier | | `instrument_code`| Defaults to all perpetual markets | | `max_page_size` | Defaults to 3 | tags: - One Trading Public REST API/Futures parameters: - name: from in: query description: 'Specifies the start of the period. ' required: false example: '2025-10-15T10:30:00Z' schema: type: string enum: - '2025-01-15' x-apidog-enum: - value: '2025-01-15' name: date-string description: 'Date strings in ' format: date-time - name: to in: query description: >- Specifies the end of the period; the range between start and end cannot exceed 90 days. required: false example: '2025-11-16T10:30:00Z' schema: type: string - name: instrument_code in: query description: >- Instrument(s) to filter by. Can be a single pair or a comma-separated string of pairs. Defaults to all instruments. required: false example: '' schema: type: string - name: cursor in: query description: >- Pointer indicating where the next page of results will be retrieved from. required: false example: '' schema: type: string - name: max_page_size in: query description: >- Sets the maximum number of results per page (default and maximum: 200). required: false example: 100 schema: type: integer responses: '200': description: '' content: application/json: schema: type: object properties: account_id: type: string description: The unique identifier for the futures account. x-apidog-mock: '{{$string.uuid}}' format: uuid funding_payments: type: object properties: instrument_code: type: string x-apidog-mock: '{{$string.symbol}}' description: >- The unique identifier for the futures market, e.g. BTC_EUR_P. funding_payment: type: string description: Funding payment amount, expressed in quote currency. cash_balance: type: string description: >- Cash balances after payment, expressed in quote currency. x-apidog-orders: - instrument_code - funding_payment - cash_balance required: - instrument_code - funding_payment - cash_balance description: Object containing funding payment details. max_page_size: type: integer description: The paginated batch size. cursor: type: integer description: >- If more records are available, pass the returned cursor into the next request to fetch the following batch of funding payments. x-apidog-orders: - account_id - funding_payments - max_page_size - cursor required: - funding_payments - account_id - max_page_size headers: {} x-apidog-name: OK '400': description: '' content: application/json: schema: title: '' type: object properties: error: type: string description: Reason x-apidog-orders: - error required: - error example: error: Reason for rejection. headers: {} x-apidog-name: Bad Request '403': description: '' content: application/json: schema: title: '' type: object properties: error: type: string description: Reason x-apidog-orders: - error required: - error example: error: Permission denied. headers: {} x-apidog-name: Forbidden '500': description: '' content: application/json: schema: title: '' type: object properties: error: type: string description: Reason x-apidog-orders: - error required: - error example: error: Server error. headers: {} x-apidog-name: ServerError security: - bearer: [] x-apidog-folder: One Trading Public REST API/Futures x-apidog-status: developing x-run-in-apidog: https://app.eu.apidog.com/web/project/349694/apis/api-3877628-run components: schemas: {} securitySchemes: bearer: type: http scheme: bearer servers: - url: https://api.onetrading.com/fast/v1 description: Production Env security: [] ```