List deposits for the authenticated client

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

GET /deposits

List deposits for the authenticated client

cURL

curl --request GET \
  --url https://v1.orchestrator.rhinestone.dev/deposit-processor/deposits

200

{
  "deposits": [
    {
      "id": "12345",
      "chain": "<string>",
      "txHash": "<string>",
      "token": "<string>",
      "amount": "1000000000000000000",
      "sender": "<string>",
      "account": "<string>",
      "targetChain": "<string>",
      "targetToken": "<string>",
      "sourceTxHash": "<string>",
      "destinationTxHash": "<string>",
      "sourceAmount": "1000000000000000000",
      "destinationAmount": "1000000000000000000",
      "createdAt": "<string>",
      "completedAt": "<string>",
      "errorCode": "<string>",
      "isSpam": true
    }
  ],
  "nextCursor": "<string>"
}

Headers

x-api-key · string

API key for authentication (omit when sending Authorization)

Example:

"your-api-key"

authorization · string

Bearer platform token (e.g. forwarded by user-service). Takes precedence over x-api-key when both are present.

Example:

"Bearer eyJhbGciOi..."

Query Parameters

account · string

EVM address (0x...) or Solana base58 public key

Example:

"0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91"

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).

Example:

"0x2ca6f15be9580c4f332656bedc11c35bf820d08d"

status · enum<string>

Filter by deposit status

Available options: pending, processing, completed, failed, expecting_refund, refunded

Example:

"failed"

chain · string

CAIP-2 chain identifier (e.g. "eip155:8453")

Pattern: ^[a-z0-9]+:[a-zA-Z0-9]+$

Example:

"eip155:8453"

txHash · string

Filter by source transaction hash (EVM 0x... or Solana base58 signature)

Example:

"0xabc123..."

limit · integer · default: 20

Maximum number of deposits to return

Required range: 1 <= x <= 100

Example:

20

cursor · string

Pagination cursor. Use the nextCursor returned by the previous page.

Pattern: ^\d+$

Example:

"123"

includeSpam · boolean

When true, include spam-flagged deposits (tokens with no known price). Defaults to false.

Example:

false

Response

200

application/json

Client deposits

deposits · object[] · required

Show child attributes

nextCursor · string | null · required