NovoPayment Exchange API

Exchange Rates

GitHub OpenAPI

Operations 1

POST /exchangerate Exchange Rates #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/novopayment:novopayment-exchange-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

novopayment-exchange-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  description: 'The Exchange rates API provides NovoPayment’s clients with the daily real-time currency exchange rate for more than 180 currencies.


    Below operations are available for Exchange Rates API:


    - Exchange Rate.'
  version: 1.0.1
  title: Rates Exchange API
  contact:
    email: support@novopaymen.com
servers:
- description: Sandbox
  url: https://sandbox-api.novopayment.com/exchangerate/v1
security:
- oAuth2ClientCredentials: []
tags:
- name: Exchange
  description: Exchange Rates
paths:
  /exchangerate:
    post:
      tags:
      - Exchange
      operationId: Exchangerate
      summary: Exchange Rates
      description: This operation can be used for FX currency conversion.
      requestBody:
        $ref: '#/components/requestBodies/RQExchangeRates'
      responses:
        '200':
          $ref: '#/components/responses/RSExchangeRates200'
        '400':
          $ref: '#/components/responses/RSExchangeRates400'
        '401':
          $ref: '#/components/responses/RS401'
        '500':
          $ref: '#/components/responses/RS500'
        default:
          $ref: '#/components/responses/RS500'
components:
  examples:
    RQToSourceCurrencyWithoutMarkup:
      value:
        exchanges:
        - brandType: VISA
          applyTo: SOURCE
          sourceCurrencyCode: '643'
          destinationCurrencyCode: '840'
          sourceAmount: 100.78
          description: conversiondetail
    InvalidTenantId:
      value:
        code: 400.09.004
        message: Invalid Tenant ID
        datetime: '2020-01-03T16:05:56.517Z'
    InternalServerError:
      value:
        code: 500.08.001
        message: Internal Server Error
        datetime: '2020-01-03T16:05:56.517Z'
    CurrencyNotSupported:
      value:
        code: 400.08.339
        message: Currency not supported
        datetime: '2020-01-03T16:05:56.517Z'
    RQToDestinationCurrencyWithoutMarkup:
      value:
        exchanges:
        - brandType: VISA
          applyTo: DESTINATION
          sourceCurrencyCode: '643'
          destinationCurrencyCode: '840'
          destinationAmount: 100
          description: conversiondetail
    InvalidSignature:
      value:
        code: 401.08.992
        message: Invalid signature
        datetime: '2020-01-03T16:05:56.517Z'
    AmountMoneyToSetIsNotAvailable:
      value:
        code: 400.08.337
        message: Amount money to set is not available
        datetime: '2020-01-03T16:05:56.517Z'
    RQToDestinationCurrencyWithMarkup:
      value:
        exchanges:
        - brandType: VISA
          applyTo: DESTINATION
          sourceCurrencyCode: '643'
          destinationCurrencyCode: '840'
          destinationAmount: 100
          markupRate: 0.1
          description: conversiondetail
    InvalidAccessToken:
      value:
        code: 401.08.993
        message: Invalid Access Token
        datetime: '2020-01-03T16:05:56.517Z'
    AccessTokenExpired:
      value:
        code: 401.08.993
        message: Access token expired
        datetime: '2020-01-03T16:05:56.517Z'
    RQToSourceCurrencyWithMarkup:
      value:
        exchanges:
        - brandType: VISA
          applyTo: SOURCE
          sourceCurrencyCode: '643'
          destinationCurrencyCode: '840'
          sourceAmount: 100
          markupRate: 0.1
          description: conversiondetail
    AccessTokenNotApproved:
      value:
        code: 401.08.991
        message: Access Token not approved
        datetime: '2020-01-03T16:05:56.517Z'
    InvalidParameters:
      value:
        code: 400.08.396
        message: Invalid parameters
        datetime: '2020-01-03T16:05:56.517Z'
        data:
          errors:
          - message: 'Field brandType: must not be blank'
    AmountIsToLowToConvert:
      value:
        code: 400.08.536
        message: Amount is to low to convert between currencies
        datetime: '2020-01-03T16:05:56.517Z'
  schemas:
    ForeignExchangeCoreResponse:
      type: object
      additionalProperties: false
      required:
      - code
      - message
      - datetime
      properties:
        code:
          type: string
          example: 200.01.000
          description: Operation response code
          maxLength: 10
          pattern: ^[0-9]{3}.[0-9]{2}.[0-9]{3}$
        message:
          type: string
          example: Process Ok
          description: Response code description
          maxLength: 140
          pattern: ^[a-zA-Z0-9\s]{1,140}$
        datetime:
          type: string
          example: '2020-01-03T16:05:56.517Z'
          description: Operation Time Stamp in ISO 8601 format
          format: date-time
          maxLength: 24
        data:
          description: Detail Response
          type: array
          maxItems: 5
          minItems: 1
          xml:
            wrapped: false
          items:
            $ref: '#/components/schemas/ForeignExchangeResponse'
    RSExchangeRates400:
      type: object
      additionalProperties: false
      properties:
        code:
          type: string
          example: 400.08.003
          description: Operation response code
          minLength: 10
          maxLength: 10
          pattern: ^[0-9]{3}.[0-9]{2}.[0-9]{3}$
        message:
          type: string
          example: Params required
          description: Response code description
          maxLength: 140
          pattern: '[a-zA-Z0-9:.\s]{1,140}'
        datetime:
          type: string
          example: '2020-01-03T16:05:56.517Z'
          format: date-time
          maxLength: 24
        data:
          type: object
          additionalProperties: false
          properties:
            errors:
              type: array
              maxItems: 50
              items:
                type: object
                additionalProperties: false
                properties:
                  message:
                    type: string
                    description: Error Detail
                    pattern: ^[a-zA-Z0-9:.\s]{1,300}$
    ForeignExchangeResponse:
      type: object
      additionalProperties: false
      properties:
        conversionRate:
          type: number
          format: decimal
          description: This is the conversion Rate.
          example: 0.0165
        markupRateApplied:
          type: number
          format: decimal
          description: Percentage of commission applied.
          example: 0.08
        destinationAmount:
          type: number
          format: decimal
          description: 'Amount in destination currency.

            __Required for apply to “SOURCE”.__

            '
          example: 1.63
        sourceAmountWithMarkup:
          type: number
          format: decimal
          description: 'Source amount with mark up.

            __Required for apply to “DESTINATION” when a mark up rate is sent.__

            '
          example: 10.8
        sourceAmountWithoutMarkup:
          type: number
          format: decimal
          description: 'Source amount without mark up.

            __Required for apply to “SOURCE” when a mark up rate is sent.__

            '
          example: 10.8
        sourceAmount:
          type: number
          format: decimal
          description: 'Amount in the source currency.

            __Required for apply to “DESTINATION”.__

            '
          example: 100
        description:
          type: string
          example: ConversionDetail
          description: Conversion Detail
          maxLength: 50
          pattern: ^[A-Za-z]+[\\s]+[A-Za-z]+$
    ExchangeRateRequestDetail:
      type: object
      additionalProperties: false
      required:
      - brandType
      - applyTo
      - sourceCurrencyCode
      - destinationCurrencyCode
      - description
      properties:
        brandType:
          type: string
          description: 'Card brand type.

            '
          example: VISA
          enum:
          - VISA
        applyTo:
          type: string
          description: 'Indicates whether the conversion rate is to the destination or source currency.

            '
          example: SOURCE
          enum:
          - SOURCE
          - DESTINATION
        sourceCurrencyCode:
          type: string
          description: 'Currency code of the source amount in ISO 4217 Numeric code or alphabetic

            __Refer to:__ [ISO Currency Codes](https://developer.novopayment.com/api/request-and-response-codes#item-isocurrencycodes\).

            '
          example: '643'
          maxLength: 3
          minLength: 3
          pattern: '[0-9]{3}|[A-Z]{3}'
        destinationCurrencyCode:
          type: string
          description: 'Currency code of the destination quantity in ISO 4217 Numeric code or alphabetic.

            __Refer to:__ [ISO Currency Codes](https://developer.novopayment.com/api/request-and-response-codes#item-isocurrencycodes\).

            '
          example: '840'
          maxLength: 3
          minLength: 3
          pattern: '[0-9]{3}|[A-Z]{3}'
        sourceAmount:
          type: number
          format: decimal
          description: 'Amount in the source currency to be converted. Includes all mark up rates.

            __Required for applying to “SOURCE” when looking for the amount in destination currency, the minimun amount is $1.__

            '
          example: 100.55
          minimum: 1
          maximum: 9999999
        destinationAmount:
          type: number
          format: decimal
          description: 'Amount in the destination currency to be converted. Excludes all mark up rates.

            __Required for applying to “DESTINATION” when looking for the amount in source currency.__

            '
          example: 1.63
          minimum: 1
          maximum: 9999999
        markupRate:
          type: number
          format: decimal
          description: 'Percentage to apply to generate a commission.

            __This value must be less than 1.__

            '
          example: 0.1
          minimum: 0
          exclusiveMaximum: 1
        description:
          type: string
          description: 'Conversion Detail.

            '
          example: ConversionPorpose
          maxLength: 50
          minLength: 1
          pattern: ^[A-Za-z]+[\\s]+[A-Za-z]+$
    ExchangeRateRequest:
      type: object
      additionalProperties: false
      required:
      - exchanges
      properties:
        exchanges:
          description: Conversion array
          type: array
          maxItems: 5
          xml:
            name: exchanges
            wrapped: true
          items:
            $ref: '#/components/schemas/ExchangeRateRequestDetail'
    RS500:
      type: object
      additionalProperties: false
      properties:
        code:
          type: string
          example: 500.08.999
          description: Operation response code
          minLength: 10
          maxLength: 10
          pattern: ^[0-9]{3}.[0-9]{2}.[0-9]{3}$
        message:
          type: string
          example: Internal Server Error
          description: Response code description
          maxLength: 140
          pattern: ^[a-zA-Z0-9\s]{1,140}$
        datetime:
          type: string
          example: '2020-01-03T16:05:56.517Z'
          format: date-time
          maxLength: 24
    RS401:
      type: object
      additionalProperties: false
      properties:
        code:
          type: string
          example: 401.08.993
          description: Operation response code
          minLength: 10
          maxLength: 10
          pattern: ^[0-9]{3}.[0-9]{2}.[0-9]{3}$
        message:
          type: string
          example: Invalid Access Token
          description: Response code description
          maxLength: 140
          pattern: ^[a-zA-Z0-9\s]{1,140}$
        datetime:
          type: string
          example: '2020-01-03T16:05:56.517Z'
          format: date-time
          maxLength: 24
  responses:
    RS401:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/RS401'
          examples:
            Invalid Access Token:
              $ref: '#/components/examples/InvalidAccessToken'
            Access Token Not Approved:
              $ref: '#/components/examples/AccessTokenNotApproved'
            Invalid Signature:
              $ref: '#/components/examples/InvalidSignature'
            Access Token Expired:
              $ref: '#/components/examples/AccessTokenExpired'
    RSExchangeRates200:
      description: OK
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ForeignExchangeCoreResponse'
          examples:
            To destination currency with mark-up:
              value:
                code: 200.08.000
                message: Process OK
                datetime: '2022-05-17T15:44:11.656Z'
                data:
                - conversionRate: 0.01
                  sourceAmount: 10.89
                  sourceAmountWithMarkup: 10.87
                  markupRateApplied: 0.08
                  description: conversiondetail
            To destination currency without mark-up:
              value:
                code: 200.08.000
                message: Process OK
                datetime: '2022-05-17T15:44:11.656Z'
                data:
                - conversionRate: 0.016
                  sourceAmount: 10.89
                  description: conversiondetail
            To source currency with mark-up:
              value:
                code: 200.08.000
                message: Process OK
                datetime: '2022-05-17T15:44:11.656Z'
                data:
                - conversionRate: 0.06
                  destinationAmount: 1.63
                  markupRateApplied: 0.08
                  sourceAmountWithoutMarkup: 10.85
                  description: conversionDetail
            To source currency without mark-up:
              value:
                code: 200.08.000
                message: Process OK
                datetime: '2022-05-17T15:44:11.656Z'
                data:
                - conversionRate: 0.0165
                  destinationAmount: 1.63
                  description: conversionDetail
    RS500:
      description: Internal Server Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/RS500'
          examples:
            Internal Server Error:
              $ref: '#/components/examples/InternalServerError'
    RSExchangeRates400:
      description: Bad Request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/RSExchangeRates400'
          examples:
            Invalid parameters:
              $ref: '#/components/examples/InvalidParameters'
            Invalid tenant id:
              $ref: '#/components/examples/InvalidTenantId'
            Currency not supported:
              $ref: '#/components/examples/CurrencyNotSupported'
            Amount money to set is not available:
              $ref: '#/components/examples/AmountMoneyToSetIsNotAvailable'
            Amount is to low to convert:
              $ref: '#/components/examples/AmountIsToLowToConvert'
  requestBodies:
    RQExchangeRates:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ExchangeRateRequest'
          examples:
            To destination currency with mark-up:
              $ref: '#/components/examples/RQToDestinationCurrencyWithMarkup'
            To destination currency without mark-up:
              $ref: '#/components/examples/RQToDestinationCurrencyWithoutMarkup'
            To source currency with mark-up:
              $ref: '#/components/examples/RQToSourceCurrencyWithMarkup'
            To source currency without mark-up:
              $ref: '#/components/examples/RQToSourceCurrencyWithoutMarkup'
      required: true
  securitySchemes:
    oAuth2ClientCredentials:
      type: oauth2
      description: 'See [Oauth2 API](https://developer.novopayment.com/api/authentication-method-and-encryption/oauth2-api)

        '
      flows:
        clientCredentials:
          tokenUrl: https://sandbox-api.novopayment.com/oauth2/token
          scopes: {}
x-provenance:
  method: harvested
  publisher: NovoPayment
  source: https://dcrpi6aufyoyb.cloudfront.net/main/exchange-rates-api/exchange-rates-api-v1.yaml.yml
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)