Onchain Actions

public/register_deposit_address

A pre-requisite before using the standard deposit method as opposed to direct contract calls. Returns the deterministic on-chain deposit address for a wallet and records it so incoming deposits are watched and credited. Pass the wallet and optionally an existing subaccount id; when creating a new subaccount (subaccount omitted or 0) a non-zero manager_id is required. Repeated calls return the same cached address and keep it alive, while new registrations are rate limited per rolling window; unused addresses are dropped after 7 days.

post/public/register_deposit_address

Request

  • Base URL: https://api.derive.xyz/v3
  • URL: https://api.derive.xyz/v3/public/register_deposit_address
  • Auth: none declared

Request body

manager_idinteger nullable

Manager the deposit routes under. Required (non-zero) when creating a new subaccount (subaccount_id omitted or 0); must be 0 or omitted for an existing subaccount — it salts the deposit address, so a nonzero value would mint a distinct escrow for the same destination.

subaccount_idinteger
walletstring required

Wallet address to watch for deposits.

Response

Success

deposit_addressstring required
manager_idinteger nullable
subaccount_idinteger nullable
walletstring required

Changes

No recorded changes to this operation across all 1 revision of this API.