Steps define what a flow does when it fires. They run sequentially in the order set by position.
trade
Buys or sells a currency pair using the account's connected exchange.
| Param | Description |
|---|---|
pair | Trading pair, e.g. "BTC/EUR", "USDC/EUR", "ETH/EUR" |
type | "buy" or "sell" |
amount | Fixed amount in the quote currency (e.g. "100"), or "use_trigger" to match the incoming payment amount (event flows only) |
All orders are placed as market orders.
Sell incoming USDC on blockchain payment:
"steps": [
{
"position": 1,
"action_type": "trade",
"action_params": { "pair": "USDC/EUR", "type": "sell", "amount": "use_trigger" }
}
]fiat_payment
Sends an outgoing SEPA payment from the account. The account must have a bank account in the specified currency with kind: "deposits".
| Param | Required | Description |
|---|---|---|
iban | yes | Recipient IBAN |
recipient | yes | Recipient name |
currency | yes | Currency of the payment, e.g. "EUR" |
amount | yes | Fixed amount, or "use_trigger" (event flows only) |
description | no | Payment reference |
city, address_line1, address_line2, country, postal_code | no | Recipient address |
swift | no | BIC/SWIFT code |
Send a fixed SEPA payout when BTC arrives:
"steps": [
{
"position": 1,
"action_type": "fiat_payment",
"action_params": {
"iban": "DE89370400440532013000",
"recipient": "ACME Corp",
"description": "BTC proceeds payout",
"currency": "EUR",
"amount": "500"
}
}
]blockchain_payment
Sends an outgoing crypto payment from the account to a blockchain wallet. The wallet can be referenced by UUID (if already saved) or created on the fly by providing its address and network.
| Param | Required | Description |
|---|---|---|
currency | yes | Currency to send, e.g. "USDC", "BTC" |
amount | yes | Fixed amount, or "use_trigger" (event flows only) |
wallet_uuid | if no address | UUID of an existing blockchain wallet |
wallet_address | if no uuid | Destination wallet address |
wallet_network | if no uuid | Network, e.g. "ethereum", "bitcoin" |
wallet_name | no | Label for the wallet when created on the fly |
Forward incoming EUR as USDC to an external wallet:
"steps": [
{
"position": 1,
"action_type": "blockchain_payment",
"action_params": {
"wallet_address": "0xabc123...",
"wallet_network": "ethereum",
"wallet_name": "ACME Payout Wallet",
"currency": "USDC",
"amount": "use_trigger"
}
}
]
