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

# Convert Currency

> Convert funds from one currency to another within a subaccount.



## OpenAPI

````yaml /api-reference/openapi.json post /v1/ramp/{subaccountId}/banking/conversions
openapi: 3.0.0
info:
  title: Bullring Finance API
  description: >-
    The Bullring Finance API allows you to build powerful cross-border payment
    solutions.
  version: 1.0.0
servers:
  - url: https://api.bullring.finance
    description: Production Server
  - url: https://staging-api.bullring.finance
    description: Sandbox Server
security:
  - x-api-key: []
tags:
  - name: Subaccounts
    description: Operations related to user subaccounts.
  - name: Verification
    description: Endpoints for subaccount verification, including KYC and KYB processes.
  - name: Balances
    description: Endpoints for retrieving account balances.
  - name: Deposits
    description: Endpoints for handling deposits into subaccounts.
  - name: Recipients
    description: Manage payment recipients for withdrawals.
  - name: Withdrawals
    description: Endpoints for handling withdrawals from subaccounts.
  - name: Conversions
    description: Endpoints for currency conversions.
  - name: Rates
    description: Endpoints for currency conversion rates.
  - name: Fees
    description: Endpoints for checking transaction fees.
  - name: Offramp
    description: Endpoints for handling offramp operations.
  - name: Onramp
    description: Endpoints for handling onramp operations.
paths:
  /v1/ramp/{subaccountId}/banking/conversions:
    post:
      tags:
        - Conversions
      summary: Convert Currency
      description: Convert funds from one currency to another within a subaccount.
      parameters:
        - name: subaccountId
          in: path
          schema:
            type: string
            format: uuid
          required: true
          description: The unique identifier of the subaccount
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConversionRequest'
            example:
              fromCurrency: USD
              toCurrency: NGN
              amount: 17
      responses:
        '200':
          description: Successful conversion
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversionResponse'
              example:
                id: dba54d80-73fc-45aa-adbe-c9c75b7f9c9a
                createdAt: '2026-01-05T00:39:12.624Z'
                from:
                  currency: USD
                  amount: 17
                to:
                  currency: BRL
                  grossAmount: 92.184761
                  netAmount: 91.904761
                feeAmount: 0.28
                feeCurrency: BRL
                rate: 5.422633
components:
  schemas:
    ConversionRequest:
      type: object
      properties:
        fromCurrency:
          type: string
          example: USD
        toCurrency:
          type: string
          example: NGN
        amount:
          type: number
          example: 17
      required:
        - fromCurrency
        - toCurrency
        - amount
    ConversionResponse:
      type: object
      properties:
        id:
          type: string
          format: uuid
          example: dba54d80-73fc-45aa-adbe-c9c75b7f9c9a
        createdAt:
          type: string
          format: date-time
          example: '2026-01-05T00:39:12.624Z'
        from:
          type: object
          properties:
            currency:
              type: string
              example: USD
            amount:
              type: number
              example: 17
        to:
          type: object
          properties:
            currency:
              type: string
              example: BRL
            grossAmount:
              type: number
              example: 92.184761
            netAmount:
              type: number
              example: 91.904761
        feeAmount:
          type: number
          example: 0.28
        feeCurrency:
          type: string
          example: BRL
        rate:
          type: number
          example: 5.422633
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key

````