---
title: "Get Funding Payments"
method: POST
path: "/trading/funding-payments"
tags: ["Trading"]
---

# Get Funding Payments

`POST /trading/funding-payments`

Get funding payment history across all or filtered perpetual connectors.

This endpoint retrieves historical funding payment records including
funding rates, payment amounts, and position data at time of payment.

Args:
    filter_request: JSON payload with filtering criteria

Returns:
    Paginated response with funding payment data and pagination metadata

Raises:
    HTTPException: 500 if there's an error fetching funding payments

## Request body

- FundingPaymentFilterRequest — Request model for filtering funding payments
  - `limit` integer — Number of items per page
  - `start_time` integer, nullable — Start time as Unix timestamp in milliseconds
  - `end_time` integer, nullable — End time as Unix timestamp in milliseconds
  - `cursor` string, nullable — Cursor for next page
  - `account_names` string[], nullable — List of account names to filter by
  - `connector_names` string[], nullable — List of connector names to filter by
  - `trading_pair` string, nullable — Filter by trading pair

## Response `200`

Successful Response

- PaginatedResponse — Generic paginated response.
  - `data` object[], required
  - `pagination` object, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/hummingbot/apis/hummingbot-api.md) · [All operations](https://skmtc.net/hummingbot/apis/hummingbot-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hummingbot/hummingbot-api/revisions/5347fe79537f/schema)