---
title: "GET /funding-transactions"
method: GET
path: "/funding-transactions"
tags: ["api-gateway"]
---

# GET /funding-transactions

`GET /funding-transactions`

Returns historical funding transactions for the authenticated user, newest first by default, paged via the response cursor. The time range is optional and unbounded; an inverted range (`end_timestamp_ns` <= `start_timestamp_ns`) is rejected with a 400. A query too expensive to serve is also rejected with a 400 asking the caller to narrow the range. Pages may be returned partial.

## Query parameters

- `account_id` string, nullable
- `symbol` string, nullable
- `end_timestamp_ns` integer, nullable
- `start_timestamp_ns` integer, nullable
- `cursor` string, nullable
- `limit` integer, nullable
- `sort_ts` 'asc' | 'desc' — Sort order/direction. - `asc`: ascending order per field type (e.g. lexicographic, numeric, etc.) - `desc`: descending order per field type

## Response `200`

List of funding transactions

- GetFundingTransactionsResponse — Page metadata for cursor-paged responses. This is intended for response bodies (not query params).
  - `limit` integer, nullable
  - `next_cursor` string, nullable
  - `total_count` integer, nullable
  - `funding_transactions` FundingTransaction[], required
    - `account_id` string, required
    - `amount` string, required
    - `benchmark_price` string, nullable
    - `currency` string, required
    - `event_id` string, required
    - `funding_amount` string, nullable — Per-contract funding cash for this event — same for every user on the same `(symbol, timestamp)`. Multiply by signed position to reconstruct the per-user `amount`. (`amount` is the actual cash booked to *this* account; `funding_amount` is the per-contract quantity that drove the calculation.)
    - `funding_rate` string, nullable
    - `reference_id` string, nullable
    - `sequence_number` integer, required
    - `settlement_price` string, required
    - `symbol` string, required
    - `timestamp` string, date-time, required
    - `transaction_type` 'funding' | 'mark_to_market' | 'final_settlement', required — Discriminator for `FundingTransaction`. All variants are a cash leg booked at a settlement price against a position; only the trigger differs.

## Other responses

- `400` — Invalid or too-expensive funding-transactions query

---

[API](https://skmtc.net/architect/apis/ax-api-gateway.md) · [All operations](https://skmtc.net/architect/apis/ax-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/architect/ax-api-gateway/versions/2955c31c524d/schema)