---
title: "List deposits for the authenticated client"
method: GET
path: "/deposits"
tags: ["Utilities"]
---

# List deposits for the authenticated client

`GET /deposits`

Returns the authenticated client's deposits, newest first. Supports filtering by account, recipient, address, status, source chain, and transaction hash. The `account` filter accepts an EVM address or a Solana public key (deposit address or swig address); `address` matches the source-chain deposit address or target-chain recipient.

## Query parameters

- `account` string — EVM address (0x...) or Solana base58 public key
- `recipient` string — Filter by the account's recipient address. Aggregates deposits across every smart account that resolves to the same recipient (typically the integrator's user wallet).
- `address` string — Filter by the source-chain deposit address or target-chain recipient.
- `status` 'pending' | 'processing' | 'completed' | 'failed' | 'rejected' | 'ignored' | 'expecting_refund' | 'refunded' | 'delayed' | 'awaiting_sweep' | 'reconciliation_required' — Filter by deposit status
- `chain` string — CAIP-2 chain identifier (e.g. "eip155:8453")
- `txHash` string — Filter by source transaction hash (EVM 0x... or Solana base58 signature)
- `limit` integer — Maximum number of deposits to return
- `cursor` string — Pagination cursor. Use the `nextCursor` returned by the previous page.
- `includeSpam` boolean — When true, include spam-flagged deposits (tokens with no known price). Defaults to false.

## Headers

- `x-api-key` string — API key for authentication (omit when sending Authorization)
- `authorization` string — Bearer platform token (e.g. forwarded by user-service). Takes precedence over `x-api-key` when both are present.

## Response `200`

Client deposits

- ListDepositsResponse
  - `deposits` DepositListItem[], required
    - `id` string, required — Deposit id. Pass to GET /deposits/{id}/quotes.
    - `chain` string, required
    - `txHash` string, required
    - `token` string, required
    - `tokenSymbol` string, nullable, required — Display symbol for `token`, resolved at read time. Null when the token could not be resolved — render the raw address.
    - `tokenDecimals` integer, nullable, required — Decimals for `token`, i.e. what makes `amount` and `sourceAmount` renderable — both are raw base units. Null when unresolved; render the raw integer rather than guessing 18.
    - `targetTokenSymbol` string, nullable, required — Display symbol for `targetToken`. Null when unresolved.
    - `targetTokenDecimals` integer, nullable, required — Decimals for `targetToken`, applying to `destinationAmount`. Null when unresolved.
    - `amount` string, required — Numeric string representing a bigint value
    - `sender` string, required
    - `recipient` string, required — Destination-chain address that receives the funds. Falls back to the smart account for EVM/HyperCore/Tron when no distinct recipient is configured; for Solana it is the EVM recipient, never the internal swig.
    - `depositAddress` string, required — Source-chain address that received the deposit (EVM smart account, Solana wallet PDA, or Tron deposit address).
    - `targetChain` string, required
    - `targetToken` string, required
    - `status` 'pending' | 'processing' | 'completed' | 'failed' | 'rejected' | 'ignored' | 'expecting_refund' | 'refunded' | 'delayed' | 'awaiting_sweep' | 'reconciliation_required', required
    - `sourceTxHash` string, nullable, required
    - `destinationTxHash` string, nullable, required
    - `sourceAmount` string, nullable, required — Numeric string representing a bigint value
    - `destinationAmount` string, nullable, required — Numeric string representing a bigint value
    - `createdAt` string, required
    - `completedAt` string, nullable, required
    - `errorCode` string, nullable, required
    - `retryable` boolean, required
    - `isSpam` boolean, required
  - `nextCursor` string, nullable, required

## Other responses

- `400` — Invalid query or API key
- `401` — Invalid or expired platform bearer token
- `403` — API key lacks required deposits scope

---

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