Flow steps

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.

ParamDescription
pairTrading pair, e.g. "BTC/EUR", "USDC/EUR", "ETH/EUR"
type"buy" or "sell"
amountFixed 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".

ParamRequiredDescription
ibanyesRecipient IBAN
recipientyesRecipient name
currencyyesCurrency of the payment, e.g. "EUR"
amountyesFixed amount, or "use_trigger" (event flows only)
descriptionnoPayment reference
city, address_line1, address_line2, country, postal_codenoRecipient address
swiftnoBIC/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.

ParamRequiredDescription
currencyyesCurrency to send, e.g. "USDC", "BTC"
amountyesFixed amount, or "use_trigger" (event flows only)
wallet_uuidif no addressUUID of an existing blockchain wallet
wallet_addressif no uuidDestination wallet address
wallet_networkif no uuidNetwork, e.g. "ethereum", "bitcoin"
wallet_namenoLabel 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"
    }
  }
]