Pair Configuration

The pair configuration endpoint checks whether a trading pair is supported and returns token configuration details.

Endpoint

GET /api/v1/pair-config

Request Parameters

Parameter	Type	Required	Description
from	string	Yes	Input token identifier
to	string	Yes	Output token identifier

Response Format

Supported Pair

{
  "from": "WEGLD-bd4d79",
  "to": "USDC-c76f1f",
  "supported": true,
  "decimalsIn": 18,
  "decimalsOut": 6,
  "minAmountIn": "1000000000",
  "minAmountInShort": 0.000000001
}

Unsupported Pair

{
  "from": "WEGLD-bd4d79",
  "to": "UNKNOWN-123456",
  "supported": false,
  "error": "unknown tokenOut"
}

No Route Available

{
  "from": "TOKEN-a1b2c3",
  "to": "TOKEN-d4e5f6",
  "supported": false,
  "error": "no path between tokens"
}

Response Fields

Field	Type	Description
from	string	Input token identifier
to	string	Output token identifier
supported	boolean	Whether the pair can be traded
decimalsIn	number	Input token decimals
decimalsOut	number	Output token decimals
minAmountIn	string	Minimum input amount (smallest units)
minAmountInShort	number	Human-readable minimum input
error	string	Error message (when supported: false)

Example Usage

Check Pair Support

curl "https://swap.xoxno.com/api/v1/pair-config?\
from=WEGLD-bd4d79&\
to=USDC-c76f1f"

JavaScript Example

async function checkPairSupport(tokenIn, tokenOut) {
  const response = await fetch(
    `https://swap.xoxno.com/api/v1/pair-config?from=${tokenIn}&to=${tokenOut}`
  );
  const config = await response.json();
  
  if (!config.supported) {
    throw new Error(`Pair not supported: ${config.error}`);
  }
  
  return {
    decimalsIn: config.decimalsIn,
    decimalsOut: config.decimalsOut,
    minAmount: BigInt(config.minAmountIn)
  };
}

Use Cases

Validate Before Quote

Always check pair configuration before requesting a quote to provide better error messages:

async function getQuoteWithValidation(from, to, amount) {
  // First, validate the pair
  const config = await checkPairSupport(from, to);
  
  if (BigInt(amount) < BigInt(config.minAmountIn)) {
    throw new Error(`Amount below minimum: ${config.minAmountInShort}`);
  }
  
  // Then get the quote
  return fetchQuote({ from, to, amountIn: amount });
}

Build Token Selector

Use pair-config to determine which tokens can be swapped:

async function getAvailableOutputTokens(inputToken, allTokens) {
  const available = [];
  
  for (const token of allTokens) {
    if (token === inputToken) continue;
    
    const config = await checkPairSupport(inputToken, token);
    if (config.supported) {
      available.push({
        token,
        decimals: config.decimalsOut
      });
    }
  }
  
  return available;
}

Token Decimals Reference

Common token decimals on MultiversX:

Token	Decimals	Min Amount Example
EGLD/WEGLD	18	0.000000001
USDC	6	0.001
USDT	6	0.001
UTK	18	0.000000001
MEX	18	0.000000001

Always use the decimals from the API response rather than hardcoded values, as some tokens may have non-standard decimals.