Accounts

Account queries

get

Path parameters

addressstringRequired

Account address in bech32m (fast1…), hex, or base64 format

Query parameters

token_balances_filterstring · nullableOptional

Comma-separated hex-encoded token IDs to include balances for. Omit to skip token balances; pass an empty value (?token_balances_filter=) to request balances for all tokens held.

state_key_filterstring · nullableOptional

Comma-separated hex-encoded state keys to return. Omit to skip state; pass an empty value to return all state keys.

Responses

200

Account info

application/json

Schema for GET /v1/accounts/{address} response.

400

Invalid address or parameters

application/json

500

Internal server error

application/json

502

Upstream validator error

application/json

get

/v1/accounts/{address}

HTTPcURLJavaScriptPython

GET /v1/accounts/{address} HTTP/1.1
Accept: */*

{
  "data": {
    "balance": "text",
    "next_nonce": 1,
    "pending_confirmation": null,
    "requested_certificates": [
      {
        "envelope": {
          "signature": {
            "Signature": "text"
          },
          "transaction": {
            "Release20260319": {
              "archival": true,
              "claim": {
                "TokenTransfer": {
                  "amount": "text",
                  "recipient": "text",
                  "token_id": "text",
                  "user_data": "text"
                }
              },
              "fee_token": null,
              "network_id": "text",
              "nonce": 1,
              "sender": "text",
              "timestamp_nanos": 1
            }
          }
        },
        "signatures": [
          []
        ]
      }
    ],
    "requested_state": [
      []
    ],
    "requested_validated_transaction": null,
    "sender": "text",
    "token_balance": [
      []
    ]
  },
  "meta": {
    "timestamp": "text"
  }
}

get

Path parameters

addressstringRequired

Account address in bech32m (fast1…), hex, or base64 format

Query parameters

from_nonceinteger · int64Required

Starting nonce (inclusive).

limitinteger · int64Required

Maximum number of certificates to return (max 200).

Responses

200

List of transaction certificates

application/json

Schema for GET /v1/accounts/{address}/certificates response.

400

Invalid address or parameters

application/json

500

Internal server error

application/json

get

/v1/accounts/{address}/certificates

HTTPcURLJavaScriptPython

GET /v1/accounts/{address}/certificates?from_nonce=1&limit=1 HTTP/1.1
Accept: */*

{
  "data": [
    {
      "envelope": {
        "signature": {
          "Signature": "text"
        },
        "transaction": {
          "Release20260319": {
            "archival": true,
            "claim": {
              "TokenTransfer": {
                "amount": "text",
                "recipient": "text",
                "token_id": "text",
                "user_data": "text"
              }
            },
            "fee_token": null,
            "network_id": "text",
            "nonce": 1,
            "sender": "text",
            "timestamp_nanos": 1
          }
        }
      },
      "signatures": [
        []
      ]
    }
  ],
  "meta": {
    "timestamp": "text"
  }
}

get

Path parameters

addressstringRequired

Multisig account address in bech32m (fast1…), hex, or base64 format

Responses

200

Pending multisig transactions

application/json

Schema for GET /v1/accounts/{address}/pending-multisig-transactions response.

400

Invalid address

application/json

500

Internal server error

application/json

502

Upstream validator error

application/json

get

/v1/accounts/{address}/pending-multisig-transactions

HTTPcURLJavaScriptPython

GET /v1/accounts/{address}/pending-multisig-transactions HTTP/1.1
Accept: */*

{
  "data": [
    {
      "signature": {
        "Signature": "text"
      },
      "transaction": {
        "Release20260319": {
          "archival": true,
          "claim": {
            "TokenTransfer": {
              "amount": "text",
              "recipient": "text",
              "token_id": "text",
              "user_data": "text"
            }
          },
          "fee_token": null,
          "network_id": "text",
          "nonce": 1,
          "sender": "text",
          "timestamp_nanos": 1
        }
      }
    }
  ],
  "meta": {
    "timestamp": "text"
  }
}