Sign in
Customers

Get customer treasury balances

Retrieve treasury balances grouped by treasury and wallet. Ideal for portfolio views showing accounts and sub-accounts. Transaction wallets are excluded.

get/v1/customers/{customerId}/treasury

Path parameters

customerIdstring required
Example:cus_abc123

Customer ID

Query parameters

treasuryIdstring
Example:trs_abc123

Treasury ID to filter to a specific treasury

view'PORTFOLIO' | 'OVERVIEW'

Treasury response shape. PORTFOLIO returns wallet-group treasuries. OVERVIEW may include provider-backed treasury entries for the treasury page.

Headers

X-API-Keystring

API key

Response

Treasury balances grouped by treasury and wallet

customerIdstring required

Customer ID

Example response

{
  "customerId": "cus_abc123",
  "treasuries": [
    {
      "id": "trs_abc123",
      "name": "Main Treasury",
      "provider": "INFINITE",
      "fundingMethods": [
        {
          "id": "vba_abc123",
          "type": "BANK_ACCOUNT",
          "provider": "INFINITE",
          "currency": "USD",
          "currencyCodes": [
            "USDC"
          ],
          "rail": "ACH",
          "rails": [
            "ACH",
            "WIRE"
          ],
          "bankName": "Infinite Bank",
          "beneficiaryName": "Acme Treasury",
          "accountNumber": "1234567890",
          "routingNumber": "021000021",
          "iban": "GB82WEST12345698765432",
          "swiftBic": "CHASUS33",
          "address": "0x1234567890abcdef1234567890abcdef12345678",
          "addressType": "EVM",
          "chains": [
            "ETHEREUM",
            "BASE"
          ]
        }
      ],
      "wallets": [
        {
          "accountId": "inw_abc123",
          "address": "0x1234567890abcdef1234567890abcdef12345678",
          "addressType": "EVM",
          "balances": [
            {
              "currency": "USDC",
              "balance": {
                "currency": "USD",
                "exponent": 2,
                "value": "12345",
                "displayValue": "123.45"
              },
              "chain": "ETHEREUM"
            }
          ]
        }
      ]
    }
  ]
}

Changes

Changed in 3 of the 19 revisions of this API.31

  • c5a90949ca591See the full diff
    • ○

      added the required property //// to the response with the status

      response-required-property-added

  • bb2702829ce01See the full diff
    • ●

      added the new ROBINHOOD enum value to the ///// response property for the response status

      response-property-enum-value-added

  • 7d6487f295d72See the full diff
    • ●

      added the new MESTA enum value to the //// response property for the response status

      response-property-enum-value-added

    • ●

      added the new MESTA enum value to the // response property for the response status

      response-property-enum-value-added