Post Pool Wallets
AuthorizationBearer <token>Scope: pool-wallets:write
Idempotency-Key*stringUnique key making the create idempotent across retries (16-64 chars of A-Z a-z 0-9 _ -).
^[a-zA-Z0-9_-]{16,64}$application/json- body
Create an account-level pool wallet (pool_balance). asset and network are required. There is no wallet_type field — the type is set server-side.
asset*stringAsset ticker for this wallet, e.g. USDT.
network*stringBlockchain network the address belongs to, e.g. tron, ethereum, bitcoin.
address?stringOn-chain wallet address.
address_tag?stringOptional memo / destination tag required by some networks.
wallet_short_description?stringOptional human-readable label.
autoexchange?booleanWhen true, deposits are auto-exchanged and settled to autoexchange_destination_bank_account_id.
falseautoexchange_destination_bank_account_id?|Bank account (bnk_…) that receives auto-exchanged funds. Required when autoexchange is true.
Idempotent replay: the Idempotency-Key matched an existing pool wallet, returned unchanged.
application/json- response
An account-level pool wallet (pool_balance). Has no subaccount. Internal provider/AML fields are omitted from the public API.
id*stringWallet ID (wal_…).
account_id*stringOwning account ID (acc_…).
asset*stringnetwork*stringaddress*stringaddress_tag?stringMemo / destination tag, when set.
wallet_type*"pool_balance""pool_balance"wallet_short_description?stringis_active*booleanautoexchange*booleanautoexchange_destination_bank_account_id?stringDestination bank account for auto-exchange, when configured.
created_at*stringdate-timeupdated_at*stringdate-timecurl -X POST 'https://api.betaramps.com/pool/wallets' \ -H 'Idempotency-Key: string' \ -H 'Content-Type: application/json' \ -d '{ "asset": "USDT", "network": "tron", "address": "TR7NHqJeYQxXgjUbi9y7GnKJkMofT4zzNF"}'{ "id": "wal_0192f4e6-1a2b-7c3d-8e4f-5a6b7c8d9e01", "account_id": "acc_0192f4e0-1a2b-7c3d-8e4f-5a6b7c8d9e01", "asset": "USDT", "network": "tron", "address": "TR7NHqJeYQxXgjUbi9y7GnKJkMofT4zzNF", "wallet_type": "pool_balance", "is_active": true, "autoexchange": false, "created_at": "2026-10-30T12:00:00Z", "updated_at": "2026-10-30T12:00:00Z"}