Create Address: POST /dac/v1/generate-address for Asset

The Create Address endpoint generates a new blockchain deposit address under your sub-account’s wallet for the specified asset. Each address carries a label that describes its intended purpose, making it easy to track funds per customer or use-case. You can set the address as part of the shared omnibus pool or keep it isolated, and optionally enable automatic gas refilling from your Gas Tank so that sweeps and transfers never stall due to insufficient fees.

Request

string

required

Your Finrock API key.

string

required

Your JWT bearer token in the format Bearer {JWT}.

string

required

The asset for which to generate an address. Use the asset_name value from the Supported Assets list (e.g. ETH, BTC, USDT_ETH).

string

required

A descriptive label that identifies the purpose of this address (e.g. customer-42, hot-wallet, treasury). Labels make it easier to reconcile deposits without storing raw addresses in your system.

boolean

default:"false"

Determines whether this address is part of the shared omnibus pool.

false — creates an isolated address; funds stay at this address until explicitly swept.
true — creates an omnibus address; incoming funds are pooled with other omnibus deposits.

boolean

default:"false"

When set to true, Finrock automatically tops up this address with gas from your Gas Tank whenever the native token balance is too low to cover transaction fees. This is always true for omnibus addresses.

Example Request

cURL

curl --request POST \
     --url https://api.finrock.io/dac/v1/generate-address \
     --header 'Authorization: Bearer {JWT}' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: YOUR_API_KEY' \
     --data '{
       "asset": "ETH",
       "label": "customer-deposit-42",
       "omnibus": false,
       "auto_refill": true
     }'

Response

A successful request returns HTTP 200 with the newly generated address object.

string

The newly generated blockchain deposit address.

string

Destination tag or memo for the address, populated only for assets that require one (e.g. XRP, XLM). null for most assets.

string

The label you provided at creation time.

boolean

true if this address was added to the omnibus pool; false if it is isolated.

boolean

true if automatic gas refilling from the Gas Tank is enabled.

Sample 200 Response

{
  "address": "0xC3d4E5f6A7b8C9d0E1f2A3b4C5d6E7f8A9b0C1d2",
  "address_tag": null,
  "label": "customer-deposit-42",
  "omnibus": false,
  "auto_refill": true
}

object

Returned when the x-api-key or Authorization header is missing or invalid.

Sample 401 Response

{
  "error": "Unauthorized",
  "message": "Invalid or missing authentication credentials."
}

Enable auto_refill on isolated addresses when you expect to sweep them frequently. This ensures gas is always available without manual intervention.

Overview

Wallets & Addresses

Transactions

Gas Tanks

Exchanges

AML

Invoicing

Utilities

Create Address: POST /dac/v1/generate-address for Asset

Request

Example Request

Response

​Request

​Example Request

​Response

Request

Example Request

Response