Create Wallets and Deposit Addresses

Manual Sweep

Manual Sweep lets you consolidate all funds from a non-omnibus (isolated) address directly into the omnibus wallet in a single operation. This is useful for periodic consolidation or when you need to move balances before closing an isolated address.

Call POST /dac/v1/invoke-sweep with the asset and the source address:

curl --request POST \
     --url https://api.finrock.io/dac/v1/invoke-sweep \
     --header 'Authorization: Token {JWT}' \
     --header 'x-api-key: YOUR_API_KEY' \
     --header 'content-type: application/json' \
     --header 'accept: application/json' \
     --data '{
       "asset": "ETH",
       "address": "0xYourIsolatedAddressHere"
     }'

Manual Sweep works only for non-omnibus addresses. The sweep moves the entire balance of the specified asset. The operation will fail if your Gas Tank does not hold sufficient funds to cover the network fee — top up your Gas Tank before invoking a sweep if needed.

Auto-Forwarding

Auto-Forwarding automatically routes incoming deposits from a Finrock address to a designated external address on a configurable schedule. This is ideal for treasury flows where you want funds to leave the platform on a regular cadence without manual intervention.

Configure Auto-Forwarding with POST /dac/v1/auto-forwarding:

curl --request POST \
     --url https://api.finrock.io/dac/v1/auto-forwarding \
     --header 'Authorization: Token {JWT}' \
     --header 'x-api-key: YOUR_API_KEY' \
     --header 'content-type: application/json' \
     --header 'accept: application/json' \
     --data '{
       "asset": "BTC",
       "address": "bc1qExternalAddressHere",
       "frequency": "Nightly"
     }'

Frequency options:

Value	Behaviour
`Nightly`	Batches all incoming funds and forwards them once per night
`RealTime`	Forwards funds to the external address immediately upon receipt

Use Nightly frequency to consolidate multiple small deposits into a single forwarding transaction, reducing total network fees. Use RealTime when your downstream system requires immediate settlement.

Get Started

Core Concepts

Guides

AI Agents

Platform Reference

Create Wallets and Deposit Addresses

Manual Sweep

Auto-Forwarding