Get supported chain config

Returns supported chains, token lists, contract addresses, and per-token Off-ramp and FX amount limits (minTopUpAmount, maxTopUpAmount, minFxAmount, maxFxAmount). Works logged in (adds balances and card eligibility) and logged out (config only). Read limits at request time; do not hardcode them.

get

/api/v3/config/chain-configs

Header parameters

tokenIdstringOptional

The user's URID. Omit for a non-logged-in query (config only, no balances).

networkstringOptional

Network identifier: 5000 for mainnet, 5003 for testnet.

signstringOptional

Signature generated by the user's wallet key (EIP-191).

hashstringOptional

SHA3/Keccak256 hash of the original request payload.

deadlinestringOptional

Signature expiry: server timestamp plus a validity window (max 20 minutes).

Responses

200

Response envelope. For the user API, retCode 0 means success; for the partner API, code 0 means success. Business rejections return HTTP 200 with a non-zero code.

application/json

Standard response envelope for the user API (api.ur.app).

retCodeinteger · int64Required

0 on success; non-zero indicates failure.

retMsgstringRequired

Human-readable message; error details when retCode is non-zero.

resultanyOptional

Business payload. Shape depends on the endpoint; some endpoints return it as a JSON-encoded string.

timeNowinteger · int64Optional

Server timestamp in milliseconds.

get/api/v3/config/chain-configs

GET /api/v3/config/chain-configs HTTP/1.1
Host: api.ur.app
Accept: */*

200

Response envelope. For the user API, retCode 0 means success; for the partner API, code 0 means success. Business rejections return HTTP 200 with a non-zero code.

{
  "retCode": 0,
  "retMsg": "success",
  "result": {
    "chains": [
      {
        "chainIdentifier": "eip155:5000",
        "chainName": "Mantle",
        "tokens": [
          {
            "symbol": "USDC",
            "decimals": 6,
            "canDeposit": true,
            "aggregatorSupported": true
          }
        ],
        "depositContract": "0x8C922114d626305E8ebC38559f17A84b31f31f17"
      }
    ],
    "canActivateCard": true
  },
  "timeNow": 1716259400000
}