This API allows you to create and manage cryptocurrency addresses for receiving payments.
The crypto address object Unique identifier with addr_ prefix (e.g., addr_abc123def456).
The cryptocurrency address.
Currency code (e.g., BTC, ETH).
The wallet ID this address belongs to.
Blockchain explorer information. Name of the blockchain explorer (e.g., Blockchain.com, Etherscan).
URL to view the address on the explorer.
When the address was created (ISO 8601).
When the address was last updated (ISO 8601).
List crypto addresses Retrieves a paginated list of all crypto addresses in your account. Addresses are ordered by creation date (newest first).
Page number for pagination. Results are returned 25 items per page.
curl https://api.gettrxn.com/v1/crypto_addresses \ -H "Authorization: Bearer $TRXN_TOKEN "
{ "crypto_addresses" : [ { "id" : "addr_abc123def456" , "object" : "crypto_address" , "address" : "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh" , "currency" : "BTC" , "wallet_id" : "wall_xyz789" , "explorer" : { "name" : "Blockchain.com" , "url" : "https://www.blockchain.com/explorer/addresses/btc/bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh" }, "created_at" : "2025-01-25T12:00:00Z" , "updated_at" : "2025-01-25T12:00:00Z" } ], "pagination" : { "page" : 1 , "pages" : 3 , "count" : 67 } }
Get crypto address GET /v1/crypto_addresses/:id
Retrieves a specific crypto address by ID.
The address’s ID (e.g., addr_abc123def456).
curl https://api.gettrxn.com/v1/crypto_addresses/addr_abc123def456 \ -H "Authorization: Bearer $TRXN_TOKEN "
{ "id" : "addr_abc123def456" , "object" : "crypto_address" , "address" : "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh" , "currency" : "BTC" , "wallet_id" : "wall_xyz789" , "explorer" : { "name" : "Blockchain.com" , "url" : "https://www.blockchain.com/explorer/addresses/btc/bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh" }, "created_at" : "2025-01-25T12:00:00Z" , "updated_at" : "2025-01-25T12:00:00Z" }
Create crypto address POST /v1/crypto_addresses
Creates a new crypto address in a wallet. The wallet can be either an account wallet or a customer wallet.
The wallet’s ID (e.g., wall_xyz789). Must belong to your account.
The currency code (e.g., BTC, ETH). Must be a supported currency.
The cryptocurrency address. Validated based on the currency format.
curl -X POST https://api.gettrxn.com/v1/crypto_addresses \ -H "Authorization: Bearer $TRXN_TOKEN " \ -H "Content-Type: application/json" \ -d '{ "wallet_id": "wall_xyz789", "currency_code": "BTC", "address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh" }'
{ "id" : "addr_new123abc456" , "object" : "crypto_address" , "address" : "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh" , "currency" : "BTC" , "wallet_id" : "wall_xyz789" , "explorer" : { "name" : "Blockchain.com" , "url" : "https://www.blockchain.com/explorer/addresses/btc/bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh" }, "created_at" : "2025-01-25T14:30:00Z" , "updated_at" : "2025-01-25T14:30:00Z" }
Error responses { "error" : { "type" : "invalid_request_error" , "code" : "resource_not_found" , "message" : "Wallet not found" , "param" : "wallet_id" } }
{ "error" : { "type" : "invalid_request_error" , "code" : "resource_not_found" , "message" : "Currency not found: DOGE" , "param" : "currency_code" } }
{ "error" : { "type" : "invalid_request_error" , "code" : "parameter_invalid" , "message" : "Address is already in use for this currency in your account" , "param" : "address" } }
Delete crypto address DELETE /v1/crypto_addresses/:id
Deletes a crypto address from your account.
Deleting an address will also delete any associated payment claims and transaction records.
The address’s ID (e.g., addr_abc123def456).
curl -X DELETE https://api.gettrxn.com/v1/crypto_addresses/addr_abc123def456 \ -H "Authorization: Bearer $TRXN_TOKEN "
Returns 204 No Content on successful deletion.
Address validation Addresses are validated based on their currency:
BTC : Validates Bitcoin address formats (legacy, SegWit, native SegWit).ETH : Validates Ethereum address format (0x followed by 40 hex characters).
Supported currencies Currency Explorer BTCBlockchain.com ETHEtherscan
Sandbox support The API respects sandbox scoping. If your API token is associated with a sandbox, you can only access addresses created in that sandbox. Address uniqueness is enforced separately within each sandbox.
