EBANX

EBANX FX API

Quote current FX rates between a merchant pricing currency (typically USD or EUR) and EBANX market currencies, and mint a short-lived FX token to lock a rate so a quoted price is honored when the underlying Direct Payment is captured.

EBANX FX API is one of 6 APIs that EBANX publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 machine-runnable capability that can be deployed as REST, MCP, or Agent Skill surfaces via Naftiko.

Tagged areas include Foreign Exchange, FX, and Cross-Border. The published artifact set on APIs.io includes an API reference, an OpenAPI specification, and 1 Naftiko capability spec.

GitHub OpenAPI

Documentation

📖
APIReference
https://docs.ebanx.com/api/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/ebanx/refs/heads/main/openapi/ebanx-fx-api-openapi.yml

Other Resources

🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/ebanx/refs/heads/main/capabilities/foreign-exchange.yaml

OpenAPI Specification

ebanx-fx-api-openapi.yml Raw ↑ 
openapi: 3.0.3
info:
  title: EBANX FX API
  version: '1.0'
  description: >-
    Retrieve current foreign exchange rates between local market currencies
    (BRL, MXN, COP, ARS, CLP, PEN, etc.) and pricing currencies (USD, EUR),
    and lock a rate via an FX token so a quoted price is honored at capture.
  contact:
    name: EBANX Sales Engineering
    email: [email protected]
    url: https://docs.ebanx.com
servers:
  - url: https://api.ebanxpay.com
    description: Production environment
  - url: https://sandbox.ebanxpay.com
    description: Sandbox environment for testing
security:
  - integrationKey: []
paths:
  /ws/exchange:
    post:
      summary: Get Exchange Rate
      operationId: getExchangeRate
      description: Return the current FX rate between a merchant pricing currency and a local payment currency for a given country.
      tags: [FX]
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [integration_key, merchant_payment_code]
              properties:
                integration_key: { type: string }
                merchant_payment_code: { type: string }
                currency_code: { type: string, description: 'Source / merchant currency.' }
                country: { type: string, description: 'Target country whose local currency is being quoted.' }
      responses:
        '200':
          description: FX quote
          content:
            application/json:
              schema:
                type: object
                properties:
                  status: { type: string }
                  currency_rate:
                    type: object
                    properties:
                      currency_code: { type: string }
                      country: { type: string }
                      rate: { type: number, format: float }
  /ws/fxtoken/get:
    post:
      summary: Get FX Token
      operationId: getFxToken
      description: >-
        Reserve an FX rate by minting a short-lived FX token. The token can be
        attached to a Direct Payment request to guarantee the previously quoted
        rate when the transaction is settled.
      tags: [FX]
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [integration_key, currency_base_code, currency_ext_code, country]
              properties:
                integration_key: { type: string }
                currency_base_code: { type: string }
                currency_ext_code: { type: string }
                country: { type: string }
      responses:
        '200':
          description: FX token
          content:
            application/json:
              schema:
                type: object
                properties:
                  status: { type: string }
                  fx_token:
                    type: object
                    properties:
                      token: { type: string }
                      expires_at: { type: string, format: date-time }
                      rate: { type: number, format: float }
components:
  securitySchemes:
    integrationKey:
      type: apiKey
      in: header
      name: x-ebanx-integration-key