# 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"}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.unigox.com/api-reference/liquidity.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.