> ## 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://app.stainless.com/api/spec/documented/augustus/openapi.documented.yml) 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.

# Off-ramp

> Deposit crypto funds to your Augustus wallet and off-ramp to fiat to fund your fiat operations

Convert USDC into fiat and pay it out to a bank account in two steps:

1. Create a conversion.
2. Create a payout.

## Supported currencies

* **Stablecoins:** USDC on Ethereum, Solana, Polygon.
* **Fiat:** EUR, GBP, USD.

<Note>
  Minimum off-ramp amount: 10 units of source currency.
</Note>

## Steps

<Note>
  Account IDs are shown in the Dashboard under **Accounts → Details**.
</Note>

<Steps>
  <Step title="Deposit USDC to your stablecoin wallet">
    Find your chain and address in the Dashboard under **Accounts → select wallet account → Linked wallets**. Send USDC only from a [linked wallet](/docs/accounts/wallets#linked-wallets).
  </Step>

  <Step title="Verify your stablecoin balance">
    <Tabs>
      <Tab title="2026-05-01">
        ```ts theme={null}
        import Augustus from '@augustusbank/typescript-sdk'

        const client = new Augustus()
        const balance = await client.accounts.retrieveBalance('your-usdc-account-id')
        ```

        [**GET** `/v1/accounts/{id}/balance` in the API Reference →](/api-reference/accounts/retrieve-account-balance)
      </Tab>

      <Tab title="2023-01-01">
        ```ts theme={null}
        import Ivy from '@getivy/node-sdk'

        const client = new Ivy()
        const balance = await client.balance.retrieve({ currency: 'USDC' })
        ```

        [**POST** `/api/service/balance/retrieve` in the API Reference →](/api-reference/banking/retrieve-account-balance)
      </Tab>
    </Tabs>
  </Step>

  <Step title="Get a quote">
    <Tabs>
      <Tab title="2026-05-01">
        ```ts theme={null}
        import Augustus from '@augustusbank/typescript-sdk'

        const client = new Augustus()
        const quote = await client.quotes.indicative.retrieve({
          source_currency: 'USDC',
          target_currency: 'EUR',
          source_amount: '100',
        })
        ```

        [**GET** `/v1/quotes/indicative` in the API Reference →](/api-reference/quotes/get-indicative-quote)
      </Tab>

      <Tab title="2023-01-01">
        ```ts theme={null}
        import Ivy from '@getivy/node-sdk'

        const client = new Ivy()
        const rate = await client.fx.retrieveRate({
          sourceCurrency: 'USDC',
          targetCurrency: 'EUR',
          sourceAmount: '100',
        })
        ```

        [**POST** `/api/service/fx/retrieve-rate` in the API Reference →](/api-reference/fx/retrieve-exchange-rate)
      </Tab>
    </Tabs>
  </Step>

  <Step title="Execute the conversion">
    <Tabs>
      <Tab title="2026-05-01">
        ```ts theme={null}
        import Augustus from '@augustusbank/typescript-sdk'

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

        [**POST** `/v1/conversions` in the API Reference →](/api-reference/conversions/create-conversion)
      </Tab>

      <Tab title="2023-01-01">
        ```ts theme={null}
        import Ivy from '@getivy/node-sdk'

        const client = new Ivy()
        const fx = await client.fx.execute({
          sourceAccountId: 'your-usdc-account-id',
          targetAccountId: 'your-eur-account-id',
          sourceAmount: '100',
        })
        ```

        [**POST** `/api/service/fx/execute` in the API Reference →](/api-reference/fx/execute-fx)
      </Tab>
    </Tabs>
  </Step>

  <Step title="Wait for the conversion to complete">
    Conversions are asynchronous. Poll or subscribe to webhooks.

    <Tabs>
      <Tab title="2026-05-01">
        ```ts theme={null}
        const result = await client.conversions.retrieve(conversionId)
        if (result.status !== 'completed') {
          // still pending or failed
        }
        ```

        [**GET** `/v1/conversions/{id}` in the API Reference →](/api-reference/conversions/retrieve-conversion)
      </Tab>

      <Tab title="2023-01-01">
        ```ts theme={null}
        const fx = await client.fx.retrieve({ fxId })
        if (fx.status !== 'succeeded') {
          // still initiated or failed
        }
        ```

        [**POST** `/api/service/fx/retrieve` in the API Reference →](/api-reference/fx/retrieve-fx-details)
      </Tab>
    </Tabs>
  </Step>

  <Step title="Pay out fiat to a bank account">
    <Tabs>
      <Tab title="2026-05-01">
        ```ts theme={null}
        import Augustus from '@augustusbank/typescript-sdk'

        const client = new Augustus()
        const payout = await client.payouts.create({
          source_account_id: 'your-eur-account-id',
          amount: '100',
          currency: 'EUR',
          reference: 'Off-ramp payout',
          destination: {
            type: 'iban',
            iban: 'DE89370400440532013000',
            account_holder_name: 'Acme Ltd',
          },
        })
        ```

        [**POST** `/v1/payouts` in the API Reference →](/api-reference/payouts/create-payout)
      </Tab>

      <Tab title="2023-01-01">
        ```ts theme={null}
        import Ivy from '@getivy/node-sdk'

        const client = new Ivy()
        const payout = await client.payouts.create({
          amount: 100,
          currency: 'EUR',
          destination: {
            type: 'beneficiary',
            financialAddress: {
              type: 'iban',
              iban: {
                accountHolderName: 'Acme Ltd',
                iban: 'DE89370400440532013000',
              },
            },
          },
        })
        ```

        [**POST** `/api/service/payout` in the API Reference →](/api-reference/payout/create-a-payout)
      </Tab>
    </Tabs>
  </Step>

  <Step title="Track the payout">
    Monitor in the Dashboard or via webhooks. Funds usually arrive within minutes. Delivery can take up to 2 business days depending on the receiving bank.
  </Step>
</Steps>