Overview

A conversion is an operation that moves funds between your accounts holding different currencies.

Conversions are supported only between accounts within the same customer, and the customer must hold an active account for each currency.

If you have a USD account and want to send USDC to your friend who is also an Augustus customer, do it in two steps:

convert USD to USDC between your accounts
use payout to send USDC to the friend.

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

Payments

Conversions

Loans

Legacy (2023-01-01)

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