Skip to main content
Validate a MultiversX token pair and read amount metadata before calling the quote endpoint.

Endpoint

FieldValue
MethodGET
Path/api/v1/pair-config
Base URLhttps://swap.xoxno.com
AuthNone
AvailabilityPublic
Rate limit100 requests per second per IP

Required Params

ParamTypeDescription
fromstringInput token identifier, for example WEGLD-bd4d79.
tostringOutput token identifier, for example USDC-c76f1f.

Request

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

Success Response

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

Unsupported Response

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

Fields

FieldTypeDescription
fromstringInput token identifier.
tostringOutput token identifier.
supportedbooleanWhether the service can quote the pair.
decimalsInnumberInput token decimals. Present when supported=true.
decimalsOutnumberOutput token decimals. Present when supported=true.
minAmountInstringMinimum input amount in smallest units. Present when supported=true.
minAmountInShortnumberHuman-readable minimum input. Present when supported=true.
errorstringUnsupported reason. Present when supported=false.

Errors

StatusCauseFix
400Missing or invalid token parameter.Send both from and to.
429Per-IP rate limit exceeded.Back off and queue requests client-side.
503Service is warming up or pool snapshot is unavailable.Retry with backoff.

Verify

Before calling /api/v1/quote:
  • supported is true.
  • User input is greater than or equal to minAmountIn.
  • Amount conversion used decimalsIn.
  • Display conversion for the expected output uses decimalsOut.