Get supported pairs

GET /api/v1/pairs

Returns all supported currency pairs and their chain info for a given merchant.

Query parameters

Field	Type	Required	Description
external_merchant_id	string	Yes	Partner's merchant identifier, as registered with Bitlipa.

Response

Field	Type	Description
pairs	array	List of supported currency pair + chain combinations.
pairs[].source_currency	string	Source currency.
pairs[].destination_currency	string	Destination currency.
pairs[].chain	string	Blockchain network (CAIP-2).

Example

PythoncURLResponse — 200 OK

import hashlib, hmac, time, uuid
import requests

API_KEY = "pk_live_xxx"
API_SECRET = b"sk_live_xxx"

path = "/api/v1/pairs"
query = "external_merchant_id=merchant_123"

ts, nonce = str(int(time.time())), str(uuid.uuid4())
sig = hmac.new(
    API_SECRET,
    f"{ts}\nGET\n{path}\n{query}\n".encode(),
    hashlib.sha256,
).hexdigest()

resp = requests.get(
    f"https://api.bitlipa.com{path}?{query}",
    headers={
        "Authorization": API_KEY,
        "X-Bitlipa-Timestamp": ts,
        "X-Bitlipa-Nonce": nonce,
        "X-Bitlipa-Signature": sig,
    },
    timeout=10,
)
print(resp.json())

TS=$(date +%s); NONCE=$(uuidgen)
SIG=$(printf '%s\nGET\n/api/v1/pairs\nexternal_merchant_id=merchant_123\n' "$TS" \
  | openssl dgst -sha256 -hmac "$API_SECRET" | awk '{print $2}')

curl -G "https://api.bitlipa.com/api/v1/pairs" \
  --data-urlencode "external_merchant_id=merchant_123" \
  -H "Authorization: $API_KEY" \
  -H "X-Bitlipa-Timestamp: $TS" \
  -H "X-Bitlipa-Nonce: $NONCE" \
  -H "X-Bitlipa-Signature: $SIG"

{
  "pairs": [
    {
      "source_currency": "KES",
      "destination_currency": "USDT",
      "chain": "eip155:137"
    },
    {
      "source_currency": "KES",
      "destination_currency": "USDT",
      "chain": "eip155:1"
    }
  ]
}