Wallets

This API allows you to view cryptocurrency wallets in your account. Wallets can belong to either your account or to individual customers.

The wallet object

string

Unique identifier with wall_ prefix (e.g., wall_abc123def456).

string

Always "wallet".

string

Type of owner: account or customer.

string

ID of the owning account or customer.

array

List of crypto addresses in this wallet.

Show crypto address properties

string

Unique identifier with addr_ prefix.

string

The cryptocurrency address.

string

Currency code (e.g., BTC, ETH).

string

When the address was created (ISO 8601).

integer

Number of addresses in the wallet.

string

When the wallet was created (ISO 8601).

string

When the wallet was last updated (ISO 8601).

List wallets

GET /v1/wallets

Retrieves a paginated list of all wallets in your account, including both account wallets and customer wallets. Wallets are ordered by creation date (newest first).

integer

default:"1"

Page number for pagination. Results are returned 25 items per page.

curl https://api.gettrxn.com/v1/wallets \
  -H "Authorization: Bearer $TRXN_TOKEN"

Response

{
  "wallets": [
    {
      "id": "wall_abc123def456",
      "object": "wallet",
      "owner_type": "account",
      "owner_id": "acct_xyz789",
      "crypto_addresses": [
        {
          "id": "addr_123",
          "address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
          "currency": "BTC",
          "created_at": "2025-01-25T12:00:00Z"
        },
        {
          "id": "addr_456",
          "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f...",
          "currency": "ETH",
          "created_at": "2025-01-25T12:30:00Z"
        }
      ],
      "crypto_address_count": 2,
      "created_at": "2025-01-25T10:00:00Z",
      "updated_at": "2025-01-25T12:30:00Z"
    },
    {
      "id": "wall_ghi789jkl012",
      "object": "wallet",
      "owner_type": "customer",
      "owner_id": "cust_abc123",
      "crypto_addresses": [
        {
          "id": "addr_789",
          "address": "bc1q...",
          "currency": "BTC",
          "created_at": "2025-01-25T14:00:00Z"
        }
      ],
      "crypto_address_count": 1,
      "created_at": "2025-01-25T14:00:00Z",
      "updated_at": "2025-01-25T14:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "pages": 1,
    "count": 2
  }
}

Get wallet

GET /v1/wallets/:id

Retrieves a specific wallet by ID, including all its crypto addresses.

string

required

The wallet’s ID (e.g., wall_abc123def456).

curl https://api.gettrxn.com/v1/wallets/wall_abc123def456 \
  -H "Authorization: Bearer $TRXN_TOKEN"

Response

{
  "id": "wall_abc123def456",
  "object": "wallet",
  "owner_type": "account",
  "owner_id": "acct_xyz789",
  "crypto_addresses": [
    {
      "id": "addr_123",
      "address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
      "currency": "BTC",
      "created_at": "2025-01-25T12:00:00Z"
    },
    {
      "id": "addr_456",
      "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f...",
      "currency": "ETH",
      "created_at": "2025-01-25T12:30:00Z"
    }
  ],
  "crypto_address_count": 2,
  "created_at": "2025-01-25T10:00:00Z",
  "updated_at": "2025-01-25T12:30:00Z"
}

Wallet types

Account wallets

Account wallets belong to your main account and are used for receiving payments directly to your business.

owner_type: "account"
owner_id: Your account ID (e.g., acct_xyz789)

Customer wallets

Customer wallets are automatically created for each customer and are used for customer-specific payment tracking.

owner_type: "customer"
owner_id: The customer’s ID (e.g., cust_abc123)

Automatic wallet creation

Account wallets are created automatically when your account is created. Customer wallets are created automatically when a customer is created. You do not need to create wallets manually.

Adding addresses to wallets

Use the Crypto Addresses API to add addresses to a wallet:

curl -X POST https://api.gettrxn.com/v1/crypto_addresses \
  -H "Authorization: Bearer $TRXN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_id": "wall_abc123def456",
    "currency_code": "BTC",
    "address": "bc1q..."
  }'

Sandbox support

The API respects sandbox scoping. If your API token is associated with a sandbox, you can only access wallets in that sandbox. Customer wallets for sandboxed customers are automatically sandboxed. Wallet data is isolated from production data.

Introduction

Core resources

Billing

Crypto

Webhooks

The wallet object

List wallets

Get wallet

Wallet types

Account wallets

Customer wallets

Automatic wallet creation

Adding addresses to wallets

Sandbox support

​The wallet object

​List wallets

​Get wallet

​Wallet types

​Account wallets

​Customer wallets

​Automatic wallet creation

​Adding addresses to wallets

​Sandbox support

The wallet object

List wallets

Get wallet

Wallet types

Account wallets

Customer wallets

Automatic wallet creation

Adding addresses to wallets

Sandbox support