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

# Convert between two wallets of the calling business

> Idempotent on `reference`. Converts at the base provider amount (the provider quote to_amount) with no business fee or spread. Not yet available to all businesses.



## OpenAPI

````yaml /novacrust-open-api-v2.yaml post /api/v1/business/open/conversions
openapi: 3.0.0
info:
  title: Open-API
  description: The http Integration API description
  version: '1.0'
  contact: {}
servers:
  - url: http://localhost:3050
    description: Local environment
  - url: https://api-staging.novacrust.com
    description: Staging environment
  - url: https://api-dev.novacrust.com
    description: Develop environment
security:
  - api-key: []
tags:
  - name: Customer
    description: ''
  - name: Payout Methods
    description: ''
  - name: Beneficiary
    description: ''
  - name: Payout
    description: ''
  - name: Transactions
    description: ''
  - name: Buy Gift Card
    description: ''
  - name: Sell Gift Card
    description: ''
  - name: Miscellaneous
    description: ''
  - name: Wallets
    description: ''
paths:
  /api/v1/business/open/conversions:
    post:
      tags:
        - Conversions
      summary: Convert between two wallets of the calling business
      description: >-
        Idempotent on `reference`. Converts at the base provider amount (the
        provider quote to_amount) with no business fee or spread. Not yet
        available to all businesses.
      operationId: create
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OpenApiCreateConversionDTO'
      responses:
        '201':
          description: ''
components:
  schemas:
    OpenApiCreateConversionDTO:
      type: object
      properties:
        from_currency:
          enum:
            - usd
            - ngn
            - ghs
            - eur
            - gbp
            - kes
            - zar
            - ugx
            - tzs
            - xof
            - rwf
            - zmw
            - xaf
            - gmd
            - lrd
            - mwk
            - etb
            - egp
            - sle
            - usdt
            - usdc
            - btc
            - eth
            - sol
            - trx
            - local_currency
          type: string
          description: Currency to convert from
          example: usd
        to_currency:
          enum:
            - usd
            - ngn
            - ghs
            - eur
            - gbp
            - kes
            - zar
            - ugx
            - tzs
            - xof
            - rwf
            - zmw
            - xaf
            - gmd
            - lrd
            - mwk
            - etb
            - egp
            - sle
            - usdt
            - usdc
            - btc
            - eth
            - sol
            - trx
            - local_currency
          type: string
          description: Currency to convert to
          example: ngn
        from_amount:
          type: number
          minimum: 1.e-8
          description: Amount of from_currency to convert (the principal)
          example: 100
        reference:
          type: string
          description: >-
            Your idempotency key. Repeating a request with the same reference
            never converts twice and returns the original result.
          example: conv-123
        expected_to_amount:
          type: number
          description: >-
            What the other side of this conversion received. Only a sanity
            check: nothing is converted if our own base amount differs from it
            by more than the allowed band.
      required:
        - from_currency
        - to_currency
        - from_amount
        - reference
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: authorization

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.