---
title: "Get Internal Transfers"
method: GET
path: "/v1/account/internal-transfers"
---

# Get Internal Transfers

`GET /v1/account/internal-transfers`

Get settled internal transfer history for the authenticated account.
Returns both inbound and outbound transfers.

## Query parameters

- `start_timestamp` integer — Start timestamp in milliseconds
- `end_timestamp` integer — End timestamp in milliseconds

## Response `200`

Internal transfer history response.

- InternalTransfers
  - `data` InternalTransfer[], required
    - `transfer_id` integer, required — Internal transfer ID
    - `asset` string, required — Asset name
    - `amount` string, required — Raw token amount including decimals. For withdrawals this matches the uint256 amount in the EIP-712 signature (e.g. "100000000" for 100 USDC with 6 decimals).
    - `direction` 'in' | 'out', required — Transfer direction relative to the authenticated account
    - `counterparty` string, required — Counterparty account address in hex format
    - `label` string — Human-readable label for a proxy key or internal transfer
    - `created_timestamp` integer, required — Creation timestamp in milliseconds
  - `more` boolean, required — More data available

## Other responses

- `400` — Bad request — the request was malformed or failed validation (bad query parameters, unparseable body, invalid signature, or a domain pre-check). The `error` field is a human-readable validation detail.
- `401` — Unauthorized — missing or invalid `POLYMARKET-PROXY` / `POLYMARKET-SECRET` credentials. `error` is `unauthorized`.
- `429` — Too Many Requests. `error` distinguishes the limit that was hit: `ip_rate_limited` (per-IP token bucket), `action_rate_limited` (per-account action rate), or `open_orders_limit` (resting open-order cap).
- `500` — Internal server error. `error` is `internal_error`.

---

[API](https://skmtc.net/polymarket/apis/polymarket-perps-http-api.md) · [All operations](https://skmtc.net/polymarket/apis/polymarket-perps-http-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polymarket/polymarket-perps-http-api/versions/e17c4709273e/schema)