Wallets

Before You Start

Read the following guides before proceeding:

---

Every corporation is funded through one address: the corporation wallet created during on-chain
registration. It holds the token balances that card issuance fees, bank transfers, corridor transfers
and FX are all settled against, and it appears in the API as the Primary wallet.

Balances are held per token. A corporation typically holds one or more of the platform's stable assets;
each balance is reported in the token's own units and converted to a reference figure for display.
Additional addresses can be registered as Global wallets so that deposits arriving on other chains are
attributed to the corporation.

Assets are converted through the FX flow, which is deliberately not a debit: Wirex quotes the swap and
returns a deposit address, and the corporation sends the source tokens itself before the swap executes.

Funding and Conversion (Simplified)

Detailed documentation available in Wallets and Balances,
Global Wallets and FX.

sequenceDiagram
    participant App as Your App
    participant Corp as Wirex Corporate API
    participant Chain as Blockchain

    App->>Corp: 1. GET /api/v1/wallets
    Corp-->>App: wallets[] with balances[]

    Note over App,Corp: Converting an asset
    App->>Corp: 2. POST /api/v1/fx/estimate
    Corp-->>App: estimation_id, deposit_address
    App->>Chain: 3. Transfer source tokens to deposit_address
    Chain-->>App: payment_transaction_hash
    App->>Corp: 4. POST /api/v1/fx
    Corp-->>App: trade_id
    Corp->>App: POST /v2/webhooks/balances

---

Guides