List account deposits

The caller must be allowed to view wallets in a company or broker workspace (or be an admitted LP taker). API keys and OAuth clients additionally require treasury_read. Read through the configured connection holding the account’s balance credential, with the venue-connection deposit-history rules. Each first answer reads the venue’s credit history for lookbackDays (1 to 30, default 7), ending now. Optional limit (1 to 200) and cursor page credits oldest first by observation time and venue deposit id. Follow nextCursor until null. A cursor freezes the window and binds its workspace, account, asset, network and complete credit fingerprint; its window takes precedence over lookbackDays. A changed observation refuses the cursor, never skips or repeats a credit. Omit paging for the whole bounded observation. A window holding more than 1,000 records answers no credits with DEPOSIT_HISTORY_WINDOW_TOO_LARGE; read a shorter window. The 409 refusals of the account balance read, plus VENUE_ACCOUNT_FUNDING_VENUE_DISABLED when only a disabled venue holds the balance key. 403 VENUE_READ_AUTHORITY_REFUSED whenever the caller’s read authority has ended, whether the check before the read or a recheck during it sees it (reason authority_ended: the credential is revoked or expired, or no longer carries treasury_read; reason permission_withdrawn: its owner lost permission to view wallets, its membership or taker admission); a session that has itself ended answers 401.

GET /api/v1/workspaces/{workspaceId}/venue-accounts/{venueAccountId}/deposit-history

Read the venue account's deposit history

cURL

curl --request GET \
  --url https://api.tetrafi.io/api/v1/workspaces/{workspaceId}/venue-accounts/{venueAccountId}/deposit-history \
  --header 'Authorization: Bearer <token>'

200

{
  "asset": "USDT",
  "chainRef": "eip155:1",
  "connection": {
    "accountBindingStatus": "unverified",
    "accountId": "fb181171-3a8d-48ed-b2a6-240989108c3f",
    "capabilities": [
      {
        "capability": "account_identity",
        "controlRevision": 3,
        "credentialRevision": 1,
        "expiresAt": "2026-10-28T12:14:12.452753Z",
        "freshness": "expired",
        "observedAt": "2026-10-28T12:09:12.452753Z",
        "reason": "Independent account evidence is not implemented for this provider.",
        "reasonCode": "INDEPENDENT_OBSERVATIONS_UNSUPPORTED",
        "source": "provider_api",
        "state": "unsupported"
      }
    ],
    "connectionId": "381d08ba-aef7-4c69-9542-4617d700f621",
    "controlRevision": 3,
    "createdAt": "2026-10-21T11:36:33.609968Z",
    "credentialRevision": 1,
    "executionOffering": "basic",
    "executionTypeId": "valr-rfq",
    "keyFingerprint": "64bb…e1c4",
    "label": "VALR account",
    "lifecycle": "configured",
    "providerSite": "global",
    "tradePaused": false,
    "updatedAt": "2026-10-28T19:37:49.206816Z",
    "venueEnablementId": "54f228e9-254d-44b3-8f39-0d0aa0463ffc",
    "withdrawalPaused": false,
    "workspaceId": "5f56c3dd-cc2d-4ea0-8772-fa254a012e91"
  },
  "credits": null,
  "expiresAt": null,
  "networkCode": "",
  "networkConfirmed": false,
  "observedAt": null,
  "reason": "This provider/site does not expose qualified account deposit history.",
  "reasonCode": "ACCOUNT_DEPOSIT_HISTORY_UNSUPPORTED",
  "since": "2026-09-29T07:59:17.652259Z",
  "state": "unsupported",
  "until": "2026-10-29T07:59:17.652259Z"
}

Authorizations

bearer_authapi_key

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Scopes

treasury_read · bearer_auth

treasury_read · api_key

Headers

X-Workspace-Id · string<uuid>

The workspace the request acts in. An API key bound to a workspace implies it: omit the header, or send that same id (another id answers 403 WORKSPACE_SCOPE_MISMATCH). A member session must send it (400 MISSING_WORKSPACE without it).

Path Parameters

workspaceId · string · required

Current company or broker workspace

venueAccountId · string · required

Query Parameters

asset · string · required

chainRef · string · required

lookbackDays · integer<int32>

Initial history window, 1 to 30 days, default 7. On subsequent pages the cursor's frozen window takes precedence; omit lookbackDays then.

Required range: x >= 0

limit · integer<int32>

Credits per page, 1 to 200. Omit for all credits; a cursor retains its page size.

Required range: x >= 0

cursor · string

The previous nextCursor. Binds the workspace, account, asset, network, window and observed credit set. A changed observation refuses instead of skipping credits.

Response

200

application/json

A provider without qualified deposit history: unsupported, with no credited values; account capabilities trimmed to one entry (captured live, rfq be48e0453)

asset · string · required

chainRef · string · required

connection · object · required

Show child attributes

networkCode · string · required

networkConfirmed · boolean · required

False when the venue declares no network for this asset: networkCode is empty and credits are matched by asset only.

reason · string · required

reasonCode · string · required

since · string<date-time> · required

state · enum<string> · required

New values may be added; treat unknown values as other.

Available options: supported, unsupported, unverified, stale, unavailable

until · string<date-time> · required

credits · object[] | null

null means unavailable, never an empty successful history.

Show child attributes

expiresAt · string<date-time> | null

nextCursor · string | null

Next page in this same frozen window and observation; null on the last page.

observedAt · string<date-time> | null