Post Wallets
AuthorizationBearer <token>Scope: 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 a subaccount-scoped wallet. asset and network are required.
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_type?stringWallet type. Defaults to external.
"external""external""shared"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 wallet, returned unchanged.
application/json- response
A subaccount-scoped wallet. Internal provider/AML fields are omitted from the public API.
id*stringWallet ID (wal_…).
account_id*stringOwning account ID (acc_…).
subaccount_id*stringOwning subaccount ID (sub_…).
asset*stringnetwork*stringaddress*stringaddress_tag?stringMemo / destination tag, when set.
wallet_type*string"external""shared"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/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", "subaccount_id": "sub_0192f4e3-8a9b-7c6d-5e4f-3a2b1c0d9e8f", "asset": "USDT", "network": "tron", "address": "TR7NHqJeYQxXgjUbi9y7GnKJkMofT4zzNF", "wallet_type": "external", "is_active": true, "autoexchange": false, "created_at": "2026-10-30T12:00:00Z", "updated_at": "2026-10-30T12:00:00Z"}