Skip to main content
GET
/
v1
/
funding
/
balance-ledger
Get account balance ledger
curl --request GET \
  --url https://api.prod.polymarketexchange.com/v1/funding/balance-ledger
{
  "entries": [
    {
      "id": "<string>",
      "account": "<string>",
      "currency": "<string>",
      "beforeBalance": "<string>",
      "afterBalance": "<string>",
      "description": "<string>",
      "updateTime": "2023-11-07T05:31:56Z",
      "modifiedSecurityId": "<string>",
      "symbol": "<string>",
      "updateBusinessDate": "<string>"
    }
  ],
  "nextPageToken": "<string>",
  "eof": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.polymarket.us/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

​
account
string
required

Required. Fully qualified resource name of the account. Example: firms/ISV-Alice/accounts/alice-trading.

​
currency
string

Optional. ISO currency code (e.g., USD). Omit to return entries in all currencies for the account.

​
start_time
string<date-time>

Optional. Inclusive lower bound on update_time (RFC3339). Clamped upstream to 2026-05-01T00:00:00Z.

​
end_time
string<date-time>

Optional. Inclusive upper bound on update_time (RFC3339).

​
entry_types
enum<string>[]

Optional. Filter by one or more entry types from the allowlist. Requesting a suppressed type returns Aborted (HTTP 409). Multiple values can be provided. Example: entry_types=DEPOSIT&entry_types=ORDER_EXECUTION.

Allowlist of balance-ledger entry types that are exposed to clients. Internal exchange types (NETTING, SECURITY_*, CONTRACT_EXPIRATION, BEGINNING_OF_DAY, INTEREST, SETTLEMENT_FEE, etc.) are suppressed: requesting a suppressed type returns Aborted (409), and any suppressed types in upstream responses are silently filtered.

Available options:
DEPOSIT,
WITHDRAWAL,
ORDER_EXECUTION,
CORRECTION,
RESOLUTION,
MANUAL_ADJUSTMENT,
ACCOUNT_PROPERTY_ADJUSTMENT,
COMMISSION,
WITHDRAWAL_REJECTION,
MANUAL_TRANSFER,
PENDING_WITHDRAWAL_CREATION
​
symbol
string

Optional. Filter by instrument symbol (e.g., for ORDER_EXECUTION entries).

​
description
string

Optional. Substring filter on the entry description. Maximum 200 Unicode characters (not bytes); longer values return InvalidArgument.

Maximum string length: 200
​
newest_first
boolean

Optional. If true, return entries in descending update_time order. Default is false (oldest first).

​
page_size
integer<int32>

Optional. Maximum entries to return per page (max 1000). Values above 1000 return InvalidArgument.

Required range: x <= 1000
​
page_token
string

Optional. Pagination token from a previous response's nextPageToken. Omit for the first request.

Response

200 - application/json

A successful response.

​
entries
object[]

Balance ledger entries for the requested account / time window. Suppressed entry types are filtered out.

​
nextPageToken
string

Pagination token to fetch the next page. Empty when there are no more results.

​
eof
boolean

true when this response contains the final page of results.