Skip to main content

Fiat to Stablecoin (Onramp)

Brale makes it easy for you and your customers to convert USD into stablecoins via wire transfer or ACH.

There are two ways to onramp to stablecoins through the Brale API:

  • Submit a Transfer request with a source value_type of wire or ACH
  • Create an Automation, which automatically mints stablecoins to a pre-configured destination wallet when funds are received (Automatic Onramp)

Businesses can also onramp directly via the Brale Dashboard, and individuals can onramp through Brale.io.

Fiat to Stablecoin via Wire​

Here is an example of onramping to your own stablecoin (YSBC) via wire transfer by calling the Transfers endpoint with the source transfer_type of wire.

POST
https://api.brale.xyz/accounts/account_id/transfers
Request
{
  "amount": {
    "value": "100",
    "currency": "USD"
  },
  "source": {
    "value_type": "USD",
    "transfer_type": "wire"
  },
  "destination": {
    "address_id": "2VcUIonJeVQzFoBuC7LdFT0dRe4",
    "value_type": "YSBC",
    "transfer_type": "solana"
  }
}
Response
{
  "id": "transfer_123",
  "status": "pending",
  "amount": {
    "value": "100",
    "currency": "USD"
  },
  "source": {
    "transfer_type": "wire",
    "value_type": "USD"
  },
  "destination": {
    "transfer_type": "polygon",
    "value_type": "YSBC",
    "address_id": "2VcUIonJeVQzFoBuC7LdFT0dRe4"
  },
  "wire_instructions": {
    // ...Brale bank details
  }
}

Initially, the status of the transfer will be pending. Once Brale receives the funds at the bank account provided in source_deposit_instructions the stablecoins will immediately be minted to the destination wallet.

Fetching Transfers​

Query a transfer that has been created.

GET
https://api.brale.xyz/accounts/account_id/transfers/:id
Response
{
  "status": "pending",
  "amount": {
    "value": "1",
    "currency": "USD"
  },
  "created_at": "2025-02-05T19:39:14.316Z",
  "updated_at": "2025-02-05T19:39:14.316Z",
  "source": {
    "value_type": "usd",
    "transfer_type": "wire"
  },
  "destination": {
    "address_id": "2VcUIonJeVQzFoBuC7LdFT0dRe4",
    "value_type": "ysbc",
    "transfer_type": "polygon"
  }
}

Fiat to Stablecoin Automation (Automatic Onramp)​

Automations Maintenance

Automations are temporarily paused while we migrate virtual accounts for reliability and future capabilities. Target window: Sep 22-Oct 1, 2025. To learn more, please reach out to our team.

Automations provide a unique account number and routing number that accepts wire transfers and ACH deposits, and automatically mints stablecoins to a pre-defined wallet address. Businesses can use automations to direct unique pre-funding coordinates to their customers, which mint stablecoins in customers' wallets.

Here is an example of onramping to your own stablecoin (YSBC) via wire transfer by creating a fiat-to-stablecoin automation.

POST
https://api.brale.xyz/accounts/account_id/automations
Request
{
  "name": "XYZ Automation",
  "type": "USD",
  "destination": {
    "address_id": "2VcUIonJeVQzFoBuC7LdFT0dRe4",
    "value_type": "ysbc",
    "transfer_type": "Solana"
  }
}

The response will return the unique account number and routing number to direct to your customer.

Response
{
  "name": "XYZ Onramp",
  "status": "complete",
  "wire_instructions": {
    "beneficiary_name": "Jane Business",
    "bank_name": "Example Bank",
    "bank_address": "456 Commerce St., Des Moines, IA 50309",
    "beneficiary_address": "612 Commerce St., Des Moines, IA 50309",
    "account_number": "123456789",
    "routing_number": "87654321",
    "memo": "AB1C23456789"
  },
  "destination": {
    "address_id": "2VcUIonJeVQzFoBuC7LdFT0dRe4",
    "value_type": "YSBC",
    "transfer_type": "Solana"
  }
}

Brale.io (Beta)​

Brale.io is a hosted onramp you can direct your users to in order to acquire stablecoins you have created. Users can acquire your stablecoin via:

  • USDC
  • ACH (coming soon)

All KYC requirements are performed by Brale.io directly.

To get access to Brale.io, please reach out to our team at support@brale.xyz.