Transfer funds To/From an exchange

curl --request POST \
     --url https://api.finrock.io/dac/v1/transaction \
     --header 'Authorization: Bearer {JWT}' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: YOUR_API_KEY' \
     --data '{
       "asset": "USDT_ETH",
       "amount": 500,
       "source_type": "Internal",
       "destination_type": "Exchange",
       "destination_id": "Binance",
       "memo": "Top up Binance liquidity",
       "sequence_id": "exch-deposit-0001"
     }'

curl --request POST \
     --url https://api.finrock.io/dac/v1/transaction \
     --header 'Authorization: Bearer {JWT}' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: YOUR_API_KEY' \
     --data '{
       "asset": "BTC",
       "amount": 0.25,
       "source_type": "Exchange",
       "source_id": "Binance",
       "destination_type": "Internal",
       "memo": "Move Binance BTC to custody",
       "sequence_id": "exch-withdraw-0001"
     }'

POST

dac

transaction

curl --request POST \
     --url https://api.finrock.io/dac/v1/transaction \
     --header 'Authorization: Bearer {JWT}' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: YOUR_API_KEY' \
     --data '{
       "asset": "USDT_ETH",
       "amount": 500,
       "source_type": "Internal",
       "destination_type": "Exchange",
       "destination_id": "Binance",
       "memo": "Top up Binance liquidity",
       "sequence_id": "exch-deposit-0001"
     }'

curl --request POST \
     --url https://api.finrock.io/dac/v1/transaction \
     --header 'Authorization: Bearer {JWT}' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: YOUR_API_KEY' \
     --data '{
       "asset": "BTC",
       "amount": 0.25,
       "source_type": "Exchange",
       "source_id": "Binance",
       "destination_type": "Internal",
       "memo": "Move Binance BTC to custody",
       "sequence_id": "exch-withdraw-0001"
     }'

MCP scope: dac.funds (not available to AI connectors yet) Exchange transfers use the Create Transaction endpoint. To send funds to a connected exchange, set destination_type to Exchange. To fetch funds from an exchange into your Finrock wallet, set source_type to Exchange. The exchange must be added and active in your workspace; check is_added and is_active with Exchange Accounts first.

Body Parameters

This page covers the parameters used for exchange transfers. See Create Transaction for the full parameter list.

string

required

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

double

required

The amount to transfer, in the asset’s native unit. Maximum precision is 8 decimal places.

string

required

Internal when sending to an exchange. Exchange when fetching from an exchange.

string

When fetching from an exchange, the exchange name (e.g. Binance), matching the exchange value from Exchange Accounts.

string

required

Exchange when sending to an exchange. Internal when fetching from an exchange.

string

When sending to an exchange, the exchange name (e.g. Binance), matching the exchange value from Exchange Accounts.

string

A free-text note attached to the transaction record in Finrock. Not broadcast on-chain.

string

A client-generated unique identifier for idempotency. See Request Idempotency.

curl --request POST \
     --url https://api.finrock.io/dac/v1/transaction \
     --header 'Authorization: Bearer {JWT}' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: YOUR_API_KEY' \
     --data '{
       "asset": "USDT_ETH",
       "amount": 500,
       "source_type": "Internal",
       "destination_type": "Exchange",
       "destination_id": "Binance",
       "memo": "Top up Binance liquidity",
       "sequence_id": "exch-deposit-0001"
     }'

curl --request POST \
     --url https://api.finrock.io/dac/v1/transaction \
     --header 'Authorization: Bearer {JWT}' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: YOUR_API_KEY' \
     --data '{
       "asset": "BTC",
       "amount": 0.25,
       "source_type": "Exchange",
       "source_id": "Binance",
       "destination_type": "Internal",
       "memo": "Move Binance BTC to custody",
       "sequence_id": "exch-withdraw-0001"
     }'

Before fetching funds, call Exchange Balance to confirm the exchange account holds enough of the asset.

The response is the same transaction object returned by Create Transaction. Track it with List Transactions.