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

# List Current Rates

> Retrieve the latest exchange rates for one or more specified currency pairs. The returned rates reflect the actual conversion rates applied by UQPAY.

##### Usage Guidelines
- If `currency_pairs` is not provided, exchange rates for all available currency pairs will be returned.

- If the request includes unsupported currency pairs, they will be listed in the `unavailable_currency_pairs` field of the response.




## OpenAPI

````yaml /global-account/v1.6/banking.yaml get /v1/exchange/rates
openapi: 3.0.2
info:
  title: Banking API
  version: 0.0.1
  description: >
    UQPAY Banking API provides comprehensive banking and payment solutions for
    global money movement.


    ## Key Features

    - International payments and transfers

    - Multi-currency account management

    - Real-time currency conversion

    - Virtual account services

    - Fund deposit and withdrawal


    ## Authentication

    Use API keys to authenticate your client requests when utilizing UQPAY APIs.

    API keys are unique data strings used to authenticate users and enable
    access to privileged operations.

    Your API key should be kept confidential and secure at all times.


    ## Service Components

    - **Payout**: Create and manage international fund transfers to
    beneficiaries

    - **Payer**: Manage entities making payments and authorizing fund transfers

    - **Beneficiary**: Handle recipient information and bank details

    - **Balance**: View and manage multi-currency account balances

    - **Deposit**: Process incoming fund transfers

    - **Virtual Accounts**: Utilize local bank accounts in foreign currencies

    - **Conversion**: Execute currency exchange at competitive rates


    ## Getting Started

    1. Obtain API credentials

    2. Set up test environment using sandbox URL

    3. Implement authentication

    4. Start with basic operations


    ## Support

    For technical support and integration assistance, contact UQPAY support
    team.
  contact:
    name: UQPAY Support
    url: https://www.uqpay.com/support
    email: banking.tech@uqpay.com
  license:
    name: Proprietary
    url: https://www.uqpay.com/legal/api-terms
  termsOfService: https://www.uqpay.com/legal/terms
  x-api-id: banking-api-v1.6.0
  x-logo:
    url: https://uqpay.com/img/UQPAY_LogoAnimv2.gif
    backgroundColor: '#FFFFFF'
    altText: UQPAY Logo
  x-categories:
    - Banking
    - Payment Processing
    - Foreign Exchange
servers:
  - url: https://api-sandbox.uqpaytech.com/api
    description: Sandbox base URL.
  - url: https://api.uqpay.com/api
    description: Production base URL.
security: []
tags:
  - name: Balances
    description: >-
      View and manage available funds across different currencies in your
      account.
  - name: Transfers
    description: >-
      A wallet transfer resource is used for sending funds directly from your
      UQPAY account to a connected account.
  - name: Deposits
    description: >-
      Deposits are bank transfers made into your UQPAY Global Accounts for
      adding funds or collecting funds from third parties.
  - name: Virtual Accounts
    description: >-
      Virtual Accounts function as local bank accounts in foreign currencies.
      They enable worldwide fund collection with account details that allow you
      to receive funds from various platforms. Virtual Accounts can also be used
      to top up your UQPAY balance.
  - name: Payout
    description: >-
      A Payout resource is created when you send funds to a beneficiary. It
      details the beneficiary, bank details, the amount being paid, its status,
      and other relevant information. You can create the payout using either
      direct beneficiary details or a previously created beneficiary ID.
  - name: Payers
    description: >-
      The payer is the party making the payout and authorizing the transfer of
      funds from their account to the beneficiary's account.
  - name: Beneficiaries
    description: >-
      The beneficiary is the recipient of the funds and is typically the party
      who will ultimately benefit from the payout.
  - name: Conversion
    description: Manage currency conversions and exchange rates for your transactions.
  - name: Exchange Rates
    description: >-
      Retrieve real-time exchange rates for a specified currency pair or all
      available pairs.
  - name: Global Accounts
    description: >-
      ⚠️ WARNING This API version is deprecated. Eventually, a deprecated API
      version becomes unsupported. Global Accounts are foreign currency accounts
      that function as local bank accounts.
  - name: Simulator
    description: Simulate deposit transactions on the sandbox environment.
paths:
  /v1/exchange/rates:
    get:
      tags:
        - Exchange Rates
      summary: List Current Rates
      description: >
        Retrieve the latest exchange rates for one or more specified currency
        pairs. The returned rates reflect the actual conversion rates applied by
        UQPAY.


        ##### Usage Guidelines

        - If `currency_pairs` is not provided, exchange rates for all available
        currency pairs will be returned.


        - If the request includes unsupported currency pairs, they will be
        listed in the `unavailable_currency_pairs` field of the response.
      operationId: list-current-rates
      parameters:
        - $ref: '#/components/parameters/XOnBehalfOf'
        - name: currency_pairs
          in: query
          required: false
          schema:
            type: string
            example: USDEUR,USDJPY
          description: >
            A comma-separated string of currency pairs to query. Each pair must
            be a 6-letter uppercase code (e.g., `USDEUR`, `USDJPY`). 

            Multiple pairs can be provided, separated by commas, up to a maximum
            of 100 pairs.
      responses:
        '200':
          description: OK - Successfully retrieved a list of current rates.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      rates:
                        type: array
                        description: >-
                          The rate records currently available for the requested
                          currency pairs, or all available pairs if no filter
                          was provided.
                        items:
                          $ref: '#/components/schemas/RateItem'
                          type: object
                      unavailable_currency_pairs:
                        type: array
                        description: >-
                          Currency pairs from the request that are not supported
                          or have no available rates at the moment.
                        items:
                          type: string
                          example: JPYKRW
                      last_updated:
                        type: string
                        format: date-time
                        description: >-
                          The timestamp of the last rate update. Timestamp
                          follows the [ISO
                          8601](https://en.wikipedia.org/wiki/ISO_8601)
                          standard.
      security:
        - XAuthToken: []
components:
  parameters:
    XOnBehalfOf:
      in: header
      name: x-on-behalf-of
      schema:
        type: string
      required: false
      description: >
        Specifies the sub-account on whose behalf the request is made. This
        should be set to the `account_id`, which can be retrieved via the [List
        Connected
        Accounts](/account-center/v1.6/api-reference/list-connected-accounts-1).
        If omitted or empty, the request is executed using the master account.

        More information at [Connected
        Accounts](/account-center/v1.6/guide/connected-accounts).
      example: 18523f72-f4de-4f9c-bb8e-ec7d1c4f32be
  schemas:
    RateItem:
      type: object
      properties:
        buy_price:
          type: string
          description: The buy price, rounded to 4 decimal places.
          example: '0.8766'
        sell_price:
          type: string
          description: The sell price, rounded to 4 decimal places.
          example: '0.8837'
        currency_pair:
          type: string
          description: >-
            The currency pair that the rate is for. The order of currencies
            follows market conventions where applicable (e.g., `USDJPY` instead
            of `JPYUSD`).
          example: USDEUR
  securitySchemes:
    XAuthToken:
      type: apiKey
      in: header
      name: x-auth-token
      description: The API token for login provided by UQPay.

````