Read the venue account's deposit history

Requires current ViewWallets authority in a Company/Broker workspace (or 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. A bounded window, not a paged list: each answer is one live read of the venue’s own credit history for lookbackDays (1 to 30, default 7) ending now, returned whole with its since, until, observedAt and expiresAt. A window holding more than 1,000 venue records answers no credits, with reasonCode DEPOSIT_HISTORY_WINDOW_TOO_LARGE; read a shorter window. No cursor is offered because the venues’ histories have no position that stays stable from one live read to the next, so a cursor could skip or repeat a credit. 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 principal lost ViewWallets, 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.

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>

Required range: x >= 0

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

observedAt · string<date-time> | null