Create Address - Finrock

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
     }'

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

POST

dac

generate-address

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
     }'

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

MCP scope: dac.write 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.

Body Parameters

string

required

The asset for which to generate an address. Use the id 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.

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.

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

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