Manual Sweep - Finrock

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

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "Pending"
}

POST

dac

invoke-sweep

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

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "Pending"
}

MCP scope: dac.funds (not available to AI connectors yet) The Manual Sweep endpoint consolidates the entire balance of a specified non-omnibus address into the omnibus wallet for the same asset. Use this endpoint when you need to manually trigger a consolidation that would otherwise wait for the automatic sweep schedule, for example to free up funds urgently or to close an isolated address. The sweep creates an on-chain transaction, so gas fees apply on EVM-compatible and similar networks — ensure your Gas Tank is funded before invoking this endpoint.

Important constraints before invoking a sweep:

Manual Sweep only works for non-omnibus addresses. Attempting to sweep an address with omnibus: true will return an error.
Manual Sweep moves all of the specified asset’s balance from the address — partial sweeps are not supported.
Manual Sweep may fail silently or be delayed if your Gas Tank has insufficient funds to cover the network fee.

Body Parameters

string

required

The asset to sweep. Use the id value from the Supported Assets list (e.g. ETH, USDT_ETH).

string

required

The non-omnibus deposit address whose full balance you want to sweep into the omnibus wallet.

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

Response

A successful request returns HTTP 200 with the sweep transaction that was created.

string

The Finrock transaction ID of the sweep. Use it with List Transactions to follow the sweep.

string

Initial transaction status, usually Pending. See Transaction Statuses for all values.

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "Pending"
}

Before calling this endpoint, verify your Gas Tank balance using the Gas Tank Balance endpoint. On EVM chains, a sweep transaction for a token like USDT_ETH consumes ETH from the Gas Tank, not USDT.