Overview

Conversions move funds between two of your own accounts holding different currencies — for example, funding a USDC balance from your USD operating account ahead of a stablecoin payout. Paying a counterparty is a separate step: convert first, then create a payout.

Supported currency pairs

USD/USDC
USDC/USD

Supported USDC networks: Ethereum Mainnet, Solana, and Polygon.

Create a conversion

2026-05-01

import Augustus from '@augustusbank/typescript-sdk'

const client = new Augustus()
const conversion = await client.conversions.create({
  source_account_id: 'your-source-account-id',
  target_account_id: 'your-target-account-id',
  source_amount: '100',
})

POST /v1/conversions in the API Reference → In response you will get the full conversion object including its ID, which you can use later to retrieve the actual state of the conversion.

Key fields

Field	Behavior
`source_account_id`	The account you want to convert funds from
`target_account_id`	The account you want to convert funds to
`source_amount`	The amount in the source account currency
`metadata`	Key-value pairs of your own data associated with this conversion

You can get account IDs from the Dashboard under Accounts → Details or Accounts API

As of today, only USD-USDC conversions with fixed 1:1 exchange rate are supported. If you convert 100 USDC, you will receive 100 USD.

Retrieve a conversion

2026-05-01

import Augustus from '@augustusbank/typescript-sdk'

const client = new Augustus()
const conversion = await client.conversions.retrieve('conversion_id')

GET /v1/conversions/{id} in the API Reference →

List conversions

2026-05-01

import Augustus from '@augustusbank/typescript-sdk'

const client = new Augustus()
const conversions = await client.conversions.list()

GET /v1/conversions in the API Reference →

Basics

Accounts

Transactions

Payments

Conversions

Loans

Pay by Bank

Supported currency pairs

Create a conversion

Key fields

Retrieve a conversion

List conversions

​Supported currency pairs

​Create a conversion

​Key fields

​Retrieve a conversion

​List conversions

Supported currency pairs

Create a conversion

Key fields

Retrieve a conversion

List conversions