---
title: "List Spot transfers"
method: GET
path: "/v1/spot/transfers"
tags: ["Spot balances and transfers"]
---

# List Spot transfers

`GET /v1/spot/transfers`

## Request

- Base URL: `https://api.ondoperps.xyz`
- URL: `https://api.ondoperps.xyz/v1/spot/transfers`
- Auth: one of:
  - HTTP bearer
  - API key in header `ONDO-KEY-ID`

Includes Spot movements, Spot subaccount transfers, and share adjustments. Excludes trading-fee transfers; use fills for fees.

See the [Spot API guide](/api-reference/spot-api-guide). Requires authentication; API-key scope: `view`.

## Query parameters

- `cursor` string
- `limit` integer
- `startTime` integer
- `endTime` integer

## Response `200`

Success. Inspect item-level outcomes for batch operations.

- object
  - `success` boolean, required
  - `result` SpotTransfer[], nullable
    - `from` SpotWalletKey, required
      - `id` string: Account ID; defaults to the authenticated account. Must identify the same account on both sides.
      - `wallet` 'main' | 'margin' | 'spot', required
    - `to` SpotWalletKey, required
      - `id` string: Account ID; defaults to the authenticated account. Must identify the same account on both sides.
      - `wallet` 'main' | 'margin' | 'spot', required
    - `symbol` string, required: Ledger asset ID, e.g. USDC or SPY.
    - `amount` string, required: Positive amount aligned to tokenConfig.decimals; share-equivalent units for GM assets.
    - `id` string, required
    - `time` string, date-time, required
    - `type` integer, required: Numeric transfer type.
  - `pageInfo` object
    - `prevCursor` string
    - `nextCursor` string

## Other responses

- `400`: Validation error; inspect error_code and error.
- `429`: Rate limit exceeded. Slow down request frequency.

## Changes

- **2026-11-03** `1601c3adedda`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ondoperps/apis/ondo-perps-rest-api/changes/v1/spot/transfers/get.md)

---

[API](https://skmtc.dev/ondoperps/apis/ondo-perps-rest-api.md) - [All operations](https://skmtc.dev/ondoperps/apis/ondo-perps-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ondoperps/apis/ondo-perps-rest-api/revisions/1601c3adedda?raw)
