Skip to main content
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

​
id
string
Unique identifier with wall_ prefix (e.g., wall_abc123def456).
​
object
string
Always "wallet".
​
owner_type
string
Type of owner: account or customer.
​
owner_id
string
ID of the owning account or customer.
​
crypto_addresses
array
List of crypto addresses in this wallet.
​
crypto_address_count
integer
Number of addresses in the wallet.
​
created_at
string
When the wallet was created (ISO 8601).
​
updated_at
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).
​
page
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.
​
id
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.