/api/v2/{coin}/wallet/{walletId}/address
This API call is used to create a new receive address for your wallet. You may choose to call this API whenever a deposit is made. The BitGo API supports millions of addresses. Please check the “Coin-Specific Implementation” with regards to fee address management for Ethereum and consolidation transactions for Algorand and Tezos.
Note, in Ethereum, new addresses are not returned immediately. This is because creating a new Ethereum address requires a blockchain transaction, which must be confirmed before the address can be used. You can save the "id" field in the response and use it to query for the address value after a short delay.
coin
stringRequired"btc"
walletId
stringRequired"59cd72485007a239fb00282ed480da1f"
^[0-9a-f]{32}$
chain
integer 0
1
10
11
20
21
30
31
40
41
1
1
label
One oflowPriority
boolean false
gasPrice
One ofeip1559
object maxPriorityFeePerGas
string required maxFeePerGas
string required forwarderVersion
integer >= 0
<= 3
format
string cashaddr
1 2 3 4
wallet.createAddress({ label: 'My address' }).then(function (address) { // print new address console.dir(address); });
id
string 59cd72485007a239fb00282ed480da1f
^[0-9a-f]{32}$
address
string <= 250 characters
2MvrwRYBAuRtPTiZ5MyKg42Ke55W3fZJfZS
chain
integer 1
index
integer coin
string lastNonce
integer -1
wallet
string 59cd72485007a239fb00282ed480da1f
^[0-9a-f]{32}$
coinSpecific
object xlm
object balance
object updated
string <date-time>
balance
integer 50000
balanceString
string 50000
totalReceived
integer totalSent
integer confirmedBalanceString
string 40000
spendableBalanceString
string 40000
addressType
string p2sh
p2sh-p2wsh
p2wsh
p2sh
error
string required requestId
string required context
object name
string required