Flow Builder

Build your money-movement flow — pick a source asset and a BRL/PIX destination to see the path and the exact Hodle API calls.

Flow Builder

A single API for moving money. Select a source (asset + network) and a destination (BRL via PIX) to get the flow diagram and the exact API calls for your use case — copy them as cURL and ship.

On-chain transferPIX transfer
USDT WalletExternal · Tron
Fund via Tron
Hodle SwitchCustodial · KYC
Convert USDT → BRL
Deliver via PIX
BRL AccountExternal · PIX
Receive via PIX
API calls
5 steps for this flow
1Create user
curl -X POST https://api.hodle.com.br/api/user/create \
  -H 'Authorization: Bearer $HODLE_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "email": "sam@acme.com", "name": "Sam Chen" }'
2Provision wallet
curl -X POST https://api.hodle.com.br/api/wallet/create \
  -H 'Authorization: Bearer $HODLE_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "userId": "$USER_ID", "network": "tron" }'
3Submit KYC
curl -X POST https://api.hodle.com.br/api/kyc \
  -H 'Authorization: Bearer $HODLE_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "userId": "$USER_ID", "document": "..." }'
4Trigger PIX payout
curl -X POST https://api.hodle.com.br/api/wallet/payout \
  -H 'Authorization: Bearer $HODLE_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "userId": "$USER_ID", "network": "tron", "value": 5000, "pixKey": "sam@acme.com" }'
5Poll status
curl -X GET https://api.hodle.com.br/api/wallet/payout/$TRANSACTION_ID \
  -H 'Authorization: Bearer $HODLE_API_KEY'

How it maps

Each builder selection resolves to one of Hodle's documented flows:

  • USDT / USDC → BRL (PIX) — the Stable ↔ PIX flow: create user → provision wallet → KYC → fund → payout → poll.
  • BRLA → BRL (PIX) — BRLA is already BRL-pegged on Polygon; transfer directly via the payout endpoint without a swap step.
  • L-BTC → BRL (PIX) — Liquid Bitcoin deposited on the Liquid sidechain, swapped to BRL, and delivered via PIX.
  • DEPIX → BRL (PIX) — DePix token on Liquid, swapped to BRL, delivered via PIX.
  • Bitcoin (on-chain) → BRL (PIX) — on-chain BTC deposited to a Hodle Bitcoin wallet, swapped to BRL, delivered via PIX.
  • BTC (Lightning) → BRL (PIX) — the Lightning ↔ PIX flow: issue invoice → payer pays → Hodle swaps and fires the PIX-out → webhooks.

The generated calls are real endpoints — see the API Reference for full schemas, and Authentication for the bearer token.