Creates a new deposit address for the specified currency. Each currency can have multiple deposit addresses. Use this method to generate a new address for receiving deposits.
Coinbase wallet type
For Coinbase wallet type accounts the network parameter is required and selects the blockchain network of the deposit address. The networks available for each currency are returned by public/get_currencies in the coinbase_networks field; a network that is not configured for the currency is rejected. An optional label can be provided, defaulting to "deposit address". This method is available to institutional Coinbase accounts only.
Note:
For Bitcoin, a new address can be generated every 24 hours.
For ERC20, Solana and XRP only one address can be generated.
Note:
If an ERC20 address is generated, this address will be automatically added for every asset that uses ERC20 addresses.
📖 Related Article: Managing Deposits
Scope: wallet:read_write
Request
- Base URLhttps://test.deribit.com/api/v2
- URLhttps://test.deribit.com/api/v2/private/create_deposit_address
- Authnone declared
Query parameters
Currency, i.e "BTC", "ETH", "USDC"
The currency symbol.
📖 Related Article: Using the currency Parameter
Blockchain network for the wallet operation, given as a network resource name (e.g. "networks/ethereum-mainnet"). Coinbase wallet type only. The networks available for each currency are returned by public/get_currencies in the coinbase_networks field. Required for operations that target an on-chain address or a deposit address; also used to disambiguate address book entries when the same address exists on multiple networks.
Label of the address book entry
Label of the deposit address. Coinbase wallet type only.
Response
Success response
Example response
{
"result": {
"creation_timestamp": 1536569522277,
"address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"
}
}Changes
- breaking
added
subschema #1to theresponse propertyoneOflist for the response status - breaking
the
response's property type changed fromobjectto no type for status - breaking
removed the required property
/from the response with the status - breaking
removed the required property
/from the response with the status - breaking
removed the required property
/from the response with the status - breaking
removed the required property
/from the response with the status - info
added the new optional
queryrequest parameterlabel - info
added the new optional
queryrequest parameternetwork
- breaking