> For the complete documentation index, see [llms.txt](https://developers.unigox.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.unigox.com/api-reference/liquidity.md).

# Liquidity

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

## Get aggregated liquidity by trading pairs

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

```json
{"openapi":"3.0.3","info":{"title":"Unigox API Gateway","version":"1.0.0"},"tags":[{"name":"Liquidity","description":"Real-time aggregated liquidity data — available trading pairs, amount ranges, and payment methods"}],"servers":[{"url":"https://api-staging.unigox.com","description":"Sandbox server"},{"url":"https://api.unigox.com","description":"Production server"}],"security":[],"paths":{"/api/v1/partner/liquidity":{"get":{"tags":["Liquidity"],"summary":"Get aggregated liquidity by trading pairs","description":"Returns real-time aggregated liquidity data across all active off-ramp offers.\n\nUse this endpoint for **liquidity discovery** — to determine which crypto/fiat pairs\nare currently available, what fiat amount ranges are supported, and which payment\nmethods are accepted. No pricing or vendor details are returned.\n\n**Trade type semantics:** `trade_type` is expressed in partner terms.\n`SELL` means the partner sells crypto and receives fiat (the most common off-ramp direction).\n`BUY` means the partner buys crypto by sending fiat.\n\n**Eligibility:** Only offers that pass the same gates as the vendor-matching engine\nare included — the offer must be authorized, the vendor must be active and online,\nand at least one payment method option must be active.\n\n**Aggregation:** Results are grouped by `(crypto_currency_code, fiat_currency_code, trade_type)`.\nAmount ranges span the minimum and maximum across all eligible offers in the group.\nPayment methods are deduplicated and sorted alphabetically.\n\n**Authentication:** None. This is a public endpoint — no API key required.\n","responses":{"200":{"description":"Liquidity pairs retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"pairs":{"type":"array","items":{"$ref":"#/components/schemas/LiquidityPair"}}}}}}}}},"500":{"description":"Internal server error"}}}}},"components":{"schemas":{"LiquidityPair":{"type":"object","required":["crypto_currency_code","fiat_currency_code","trade_type","min_amount","max_amount","min_amount_usd","max_amount_usd","payment_methods"],"properties":{"crypto_currency_code":{"type":"string","description":"Cryptocurrency code (e.g. USDC, BTC)"},"fiat_currency_code":{"type":"string","description":"Fiat currency code (ISO 4217)"},"trade_type":{"type":"string","enum":["BUY","SELL"],"description":"Partner-facing trade direction.\n`SELL` — partner sells crypto and receives fiat (off-ramp).\n`BUY` — partner buys crypto by sending fiat (on-ramp).\n"},"min_amount":{"type":"number","format":"double","description":"Minimum fiat amount accepted across all eligible offers, in the pair's native fiat currency"},"max_amount":{"type":"number","format":"double","description":"Maximum fiat amount accepted across all eligible offers, in the pair's native fiat currency"},"min_amount_usd":{"type":"number","format":"double","description":"Minimum fiat amount converted to USD"},"max_amount_usd":{"type":"number","format":"double","description":"Maximum fiat amount converted to USD"},"payment_methods":{"type":"array","items":{"type":"string"},"description":"Deduplicated, alphabetically sorted list of payment method slugs available for this pair"}}}}}}
```