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

# Query Supported Convert Currencies

> Users can query the supported payment currency for the converted payment order, and then selects one to create an convert payment order

## Overview

This page documents the `GET /payment/open/institution/v1/pay/address/supportedconvertcurrencies` endpoint. The full schema, parameters, and examples are rendered from the linked OpenAPI definition above.

Users can query the supported payment currency for the converted payment order, and then selects one to create an convert payment order

## Notes

* Authentication uses the standard GatePay signed headers.
* This page documents the institution-path variant of the same API.
* Except for sub-account creation and sub-account query APIs, institution requests should include `X-GatePay-On-Behalf-Of`.
* For shared signing rules, see [/api-reference/version/100/en/common/securityAndSignature](/api-reference/version/100/en/common/securityAndSignature).


## OpenAPI

````yaml /api-reference/version/100/en/openapi/institution/address-payment-openapi.json GET /payment/open/institution/v1/pay/address/supportedconvertcurrencies
openapi: 3.1.0
info:
  title: GatePay Address Payment API
  description: GatePay Address Payment APIs for crypto payment via blockchain address.
  version: 1.0.0
servers:
  - url: https://openplatform.gateapi.io
security: []
paths:
  /payment/open/institution/v1/pay/address/supportedconvertcurrencies:
    get:
      summary: Query Convert Supported Currencies
      description: >-
        Users can query the supported payment currency for the converted payment
        order, and then selects one to create an convert payment order
      parameters:
        - $ref: '#/components/parameters/X-GatePay-Certificate-ClientId'
        - $ref: '#/components/parameters/X-GatePay-Signature'
        - $ref: '#/components/parameters/X-GatePay-Timestamp'
        - $ref: '#/components/parameters/X-GatePay-Nonce'
        - name: currency
          in: query
          required: true
          description: Currency of the order.
          schema:
            type: string
        - $ref: '#/components/parameters/X-GatePay-On-Behalf-Of'
      responses:
        '200':
          description: SUCCESS
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CurrenciesResponse'
              example:
                status: SUCCESS
                code: '000000'
                errorMessage: ''
                data:
                  currencies:
                    - BTC
                    - USD
                    - USDT
                    - ETH
                    - XRP
                    - ZEC
                    - GT
                    - BNB
                    - DOT
                    - SHIB
                    - LION
components:
  parameters:
    X-GatePay-Certificate-ClientId:
      name: X-GatePay-Certificate-ClientId
      in: header
      required: true
      description: Merchant client ID, obtained from GatePay platform
      schema:
        type: string
    X-GatePay-Signature:
      name: X-GatePay-Signature
      in: header
      required: true
      description: HMAC-SHA256 signature for request validation
      schema:
        type: string
    X-GatePay-Timestamp:
      name: X-GatePay-Timestamp
      in: header
      required: true
      description: >-
        Timestamp in milliseconds, must not differ from server time by more than
        5 minutes
      schema:
        type: string
    X-GatePay-Nonce:
      name: X-GatePay-Nonce
      in: header
      required: true
      description: Random nonce for replay attack prevention
      schema:
        type: string
    X-GatePay-On-Behalf-Of:
      name: X-GatePay-On-Behalf-Of
      in: header
      required: true
      schema:
        type: string
      description: >-
        Required delegated-subject header. Provide the initiating account ID for
        this request. For institution merchant APIs, this is typically the
        target sub-account ID; for institution charge and transfer APIs, it can
        be either an institution account ID or a sub-account ID.
  schemas:
    CurrenciesResponse:
      type: object
      properties:
        status:
          type: string
        code:
          type: string
        data:
          type: object
          properties:
            currencies:
              type: array
              description: List of currencies that support convert to the order currency
              items:
                type: string

````