Skip to main content
GET
/
payment
/
open
/
institution
/
v1
/
pay
/
address
/
chains
Query Supported Chains
curl --request GET \
  --url https://openplatform.gateapi.io/payment/open/institution/v1/pay/address/chains \
  --header 'X-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>' \
  --header 'X-GatePay-Nonce: <x-gatepay-nonce>' \
  --header 'X-GatePay-On-Behalf-Of: <x-gatepay-on-behalf-of>' \
  --header 'X-GatePay-Signature: <x-gatepay-signature>' \
  --header 'X-GatePay-Timestamp: <x-gatepay-timestamp>'
{
  "status": "SUCCESS",
  "code": "000000",
  "errorMessage": "",
  "data": {
    "currency": "BTC",
    "chains": [
      {
        "chain": "BTC",
        "currency": "BTC",
        "full_curr_type": "BTC",
        "symbol": "BTC",
        "explorer_url": ""
      },
      {
        "chain": "HT",
        "currency": "BTC",
        "full_curr_type": "BTC_HT",
        "symbol": "BTC_HT",
        "explorer_url": ""
      },
      {
        "chain": "BSC",
        "currency": "BTC",
        "full_curr_type": "BTC_BSC",
        "symbol": "BTC_BSC",
        "explorer_url": ""
      }
    ]
  }
}

​
Overview

This page documents the GET /payment/open/institution/v1/pay/address/chains endpoint. The full schema, parameters, and examples are rendered from the linked OpenAPI definition above. Query all available chains that support payment with the provided currency

​
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.

Headers

​
X-GatePay-Certificate-ClientId
string
required

Merchant client ID, obtained from GatePay platform

​
X-GatePay-Signature
string
required

HMAC-SHA256 signature for request validation

​
X-GatePay-Timestamp
string
required

Timestamp in milliseconds, must not differ from server time by more than 5 minutes

​
X-GatePay-Nonce
string
required

Random nonce for replay attack prevention

​
X-GatePay-On-Behalf-Of
string
required

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.

Query Parameters

​
currency
string
required

The currency to create the order in.

Response

200 - application/json

SUCCESS

​
status
string

Request status.

​
code
string

Response code.

​
data
object