Skip to main content
POST
MCP scope: dac.write Use this endpoint to add an address to a whitelist. A new address starts as UnApproved and can be used once the owner approves it in the Finrock dashboard. Check its status with List Whitelist Addresses.

Body Parameters

string
required
The ID of the whitelist, from List Whitelists. The whitelist must be active.
string
required
The wallet address. At least 10 characters. It can’t be a Finrock wallet address.
string
The asset the address is for, for example BTC. Upper-case. If you send it, Finrock checks the address against that asset’s network. If you leave it out, the address applies to all assets.
string
A label for the address.
string
The destination tag or memo, for assets that use one.

Response

integer
1000 when the address was added.
string | null
null on success.
string | null
Additional information, if any. null on success.

Errors

Finrock refuses the address in these cases:
  • The whitelist isn’t active (switched off with Edit Whitelist). The error is 400 INVALID_ACTION.
  • The address is already on the whitelist. An address added without an asset also blocks adding the same address for a specific asset.
  • The address belongs to a Finrock wallet.
  • The address is invalid for the asset’s network.