Liquidity

Real-time aggregated liquidity data — available trading pairs, amount ranges, and payment methods

Get aggregated liquidity by trading pairs

get

/api/v1/partner/liquidity

Returns real-time aggregated liquidity data across all active off-ramp offers.

Use this endpoint for liquidity discovery — to determine which crypto/fiat pairs are currently available, what fiat amount ranges are supported, and which payment methods are accepted. No pricing or vendor details are returned.

Trade type semantics: trade_type is expressed in partner terms. SELL means the partner sells crypto and receives fiat (the most common off-ramp direction). BUY means the partner buys crypto by sending fiat.

Eligibility: Only offers that pass the same gates as the vendor-matching engine are included — the offer must be authorized, the vendor must be active and online, and at least one payment method option must be active.

Aggregation: Results are grouped by (crypto_currency_code, fiat_currency_code, trade_type). Amount ranges span the minimum and maximum across all eligible offers in the group. Payment methods are deduplicated and sorted alphabetically.

Authentication: None. This is a public endpoint — no API key required.

Responses

200

Liquidity pairs retrieved successfully

application/json

successbooleanOptionalExample: true

500

Internal server error

get/api/v1/partner/liquidity

GET /api/v1/partner/liquidity HTTP/1.1
Host: api-staging.unigox.com
Accept: */*

{
  "success": true,
  "data": {
    "pairs": [
      {
        "crypto_currency_code": "USDC",
        "fiat_currency_code": "EUR",
        "trade_type": "SELL",
        "min_amount": 50,
        "max_amount": 10000,
        "min_amount_usd": 54.35,
        "max_amount_usd": 10870,
        "payment_methods": [
          "sepa",
          "wise"
        ]
      },
      {
        "crypto_currency_code": "USDC",
        "fiat_currency_code": "NGN",
        "trade_type": "SELL",
        "min_amount": 50000,
        "max_amount": 5000000,
        "min_amount_usd": 31.25,
        "max_amount_usd": 3125,
        "payment_methods": [
          "gtbank",
          "zenith-bank"
        ]
      }
    ]
  }
}