Developer API

One REST API for accounts, wallets, conversion and payouts

Idempotent by design, webhook-first, with a sandbox that mirrors production. Build your money movement once and add corridors without re-integrating.

Design Principles

Boring where it counts

Financial APIs should be predictable. Astro Breeze's API uses stable resource-oriented endpoints, explicit state machines and no silent retries.

  • REST + JSON, versioned and backward compatible
  • Idempotency keys on every write
  • Webhooks with signed payloads and replay
  • Explicit payment states — no ambiguous "processing" limbo
  • Per-environment API keys, scoped roles
Create a payoutPOST /v1/payouts
# Submit an idempotent SEPA payout
curl https://api.hotore.com/v1/payouts \
  -H "Authorization: Bearer sk_live_•••" \
  -H "Idempotency-Key: 0f1c2e..." \
  -d '{
    "source": "acct_eur_7788",
    "amount": "25000.00",
    "currency": "EUR",
    "rail": "sepa_instant",
    "counterparty": {
      "name": "Supplier GmbH",
      "iban": "DE89...."
    },
    "reference": "PO-2026-0114"
  }'
Core Resources

Four resources cover the whole flow

Accounts

Open fiat accounts, fetch balances and statements, list virtual IBANs per entity.

Wallets

Create operational wallets per currency and chain, manage allowlists and policies.

Conversions

Quote, lock and execute stablecoin ↔ fiat and fiat ↔ fiat conversions.

Payouts

Submit payouts on any supported rail with explicit states and webhooks.

Sandbox

Test the full loop before you sign anything

The sandbox issues test accounts and wallets, simulates incoming wires and on-chain deposits, and fires the same webhooks production will — so your integration is done before commercial terms are final.

  • Simulated rail behavior including delays and returns
  • Test stablecoin deposits with confirmation modeling
  • Webhook signature verification and replay tooling

Webhook events

account.creditedfiat deposit landed
wallet.creditedstablecoin deposit confirmed
conversion.settledfx conversion completed
payout.state_changedany payout lifecycle move

Get sandbox keys today

Request access and we will issue sandbox credentials and walk your team through the first payout.

Request Sandbox Access