GET/v1/deposits

List deposits

Returns a paginated list of deposits, ordered by created_at descending by default. Combine filters and pagination to scope reconciliation jobs.

Parameters

enumOptional

Filter by status. One of pending, confirming, completed, underpaid, overpaid, expired.

stringOptional

Filter by asset code (e.g. USDC).

stringOptional

Filter by chain (e.g. ethereum).

integerOptional

Unix timestamp (seconds). Returns deposits created strictly after this time.

integerOptional

Unix timestamp (seconds). Returns deposits created strictly before this time.

integerOptionalDefault: 25

Number of objects to return. Between 1 and 100.

stringOptional

Cursor for the next page. See Pagination.

enumOptionalDefault: desc

desc (newest first) or asc (oldest first).

Returns

A paginated list of Deposit objects.

List completed USDC deposits

curl "https://api.aeses.io/v1/deposits?status=completed&asset=USDC&limit=2" \
-H "x-api-key: sk_live_..."

Response

{
"object": "list",
"data": [
  {
    "id": "dep_01HXYZ7M2P5RT4VG3K8AQWE9FN",
    "object": "deposit",
    "status": "completed",
    "asset": "USDC",
    "chain": "ethereum",
    "received_amount": "99.50",
    "created_at": 1731598200
  },
  {
    "id": "dep_01HXYW3N4Q6S2VH5K7BMPRT8GJ",
    "object": "deposit",
    "status": "completed",
    "asset": "USDC",
    "chain": "polygon",
    "received_amount": "250.00",
    "created_at": 1731585412
  }
],
"has_more": true,
"next_cursor": "dep_01HXYW3N4Q6S2VH5K7BMPRT8GJ"
}