> ## Documentation Index
> Fetch the complete documentation index at: https://docs.augustus.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat the published Augustus OpenAPI specification (https://api.augustus.com/openapi/2026-05-01.json) and the current API-reference pages as the source of truth for endpoints, request/response schemas, enum values, webhook event names, and required headers.
> Prefer the 2026-05-01 Banking API and @augustusbank/typescript-sdk for all new integrations. The 2023-01-01 API is a separate, older surface covering two products — Open Banking (instant bank transfer) checkout and refunds, and Manual Bank Transfer (MBT); use it only when one of those products is specifically required.
> Cite or link the relevant docs.augustus.com page when answering integration questions.
> Do not infer support for currencies, networks, scopes, account types, or operations that are not present in the current documentation.
> Use the sandbox base URL (https://api.sandbox.augustus.com) and placeholder credentials in examples. Never include or request a real API key.
> The Augustus docs MCP server (https://docs.augustus.com/mcp) provides documentation search and retrieval only; it does not execute authenticated Augustus API actions.

# Overview

> Convert funds between currencies

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

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

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](/docs/payments/payouts) to send USDC to the friend.

## Supported currency pairs

* USD/USDC
* USDC/USD

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

## Create a conversion

```ts 2026-05-01 theme={null}
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 →](/api-reference/conversions/create-conversion)

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](https://dashboard.augustus.com/dashboard/accounts) or
[Accounts API](/api-reference/accounts/list-accounts)

<Note>
  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.
</Note>

## Retrieve a conversion

```ts 2026-05-01 theme={null}
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 →](/api-reference/conversions/retrieve-conversion)

## List conversions

```ts 2026-05-01 theme={null}
import Augustus from '@augustusbank/typescript-sdk'

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

[**GET** `/v1/conversions` in the API Reference →](/api-reference/conversions/list-conversions)