LCX Liberty DEX

Best route and expected output for selling a specific amount of one token for another on one chain, priced from the pools LCX Liberty DEX indexes itself. Use it for what an amount would swap for; use get_price for a token's value, and search_tokens first to turn a ticker into an address. Read-only: it never executes a trade. Returns output.amount and output.minimumAmount (at 0.5% slippage) in tokenOut's base units, with output.decimals to scale them; priceImpactPct, gasFeeUSD, the venues and the per-hop routes; and blockNumber and expiresAt, since a quote is priced at one block and lives 120 seconds. When there is no quote, the result is an error that says why: no route between the two tokens, or liquidity too thin for this size, usually naming a size that would fill.

{
  "type": "object",
  "properties": {
    "amount": {
      "description": "Positive human amount of tokenIn to sell, e.g. \"1.5\". Scaled by the token's own decimals, which the server knows: do not send decimals.",
      "pattern": "^\\s*(\\d+(\\.\\d*)?|\\.\\d+)([eE][+-]?\\d+)?\\s*$",
      "type": "string"
    },
    "chainId": {
      "description": "1 Ethereum, 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 4663 Robinhood Chain, 56 BNB Chain, 137 Polygon, 43114 Avalanche, 130 Unichain, 143 Monad, 5042 Arc, 999 HyperEVM",
      "enum": [
        1,
        8453,
        42161,
        10,
        4663,
        56,
        137,
        43114,
        130,
        143,
        5042,
        999
      ],
      "type": "integer"
    },
    "decimals": {
      "description": "Optional, and best left out. Only for a token the index holds no decimals for; a value that disagrees with the token's own is refused (decimals_mismatch).",
      "maximum": 36,
      "minimum": 0,
      "type": "integer"
    },
    "tokenIn": {
      "description": "Sell token address. Use the zero address for native ETH.",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "type": "string"
    },
    "tokenOut": {
      "description": "Buy token address.",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "type": "string"
    }
  },
  "required": [
    "chainId",
    "tokenIn",
    "tokenOut",
    "amount"
  ],
  "additionalProperties": false
}

Finds tokens on one chain by symbol, name or address, and gives the address get_quote and get_price need. Use it whenever you have a ticker or a name instead of an address. Read-only. Matching is case-insensitive on any part of the symbol, name or address; with no search it lists the chain's tokens. Results are ranked: the chain's curated tokens first, then other indexed tokens by how many pools hold them. A symbol is not unique, so when several match, prefer the verified one or the one with the most depth. Each result has address (the zero address for the native coin), symbol, name, decimals, verified, poolCount and depthUsd; hasMore says more matched than limit returned. A token refused for a transfer tax is left out unless its exact address is searched, which returns it with transferTaxBps.

{
  "type": "object",
  "properties": {
    "chainId": {
      "description": "1 Ethereum, 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 4663 Robinhood Chain, 56 BNB Chain, 137 Polygon, 43114 Avalanche, 130 Unichain, 143 Monad, 5042 Arc, 999 HyperEVM",
      "enum": [
        1,
        8453,
        42161,
        10,
        4663,
        56,
        137,
        43114,
        130,
        143,
        5042,
        999
      ],
      "type": "integer"
    },
    "limit": {
      "description": "Max results to return. Default 10, at most 50.",
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    },
    "search": {
      "description": "Any part of a symbol, name or address, case-insensitive, e.g. \"usdc\" or \"0x833589\". Leave it out to list the chain's tokens.",
      "type": "string"
    }
  },
  "required": [
    "chainId"
  ],
  "additionalProperties": false
}

USD price of one whole token on one chain, priced from the pools LCX Liberty DEX indexes itself (real depth, not a mid-market feed). Use it for a token's value; use get_quote for what a specific amount would swap for, and search_tokens first to turn a ticker into an address. Read-only. Returns usd, change24h (a ratio: 0.0123 is +1.23%), source, and the age of the pool state behind the price (asOfBlock, ageSeconds, stale). When there is no honest price, usd is null and reason says why (for example token_not_indexed or below_depth_floor) instead of an error.

{
  "type": "object",
  "properties": {
    "chainId": {
      "description": "1 Ethereum, 8453 Base, 42161 Arbitrum One, 10 OP Mainnet, 4663 Robinhood Chain, 56 BNB Chain, 137 Polygon, 43114 Avalanche, 130 Unichain, 143 Monad, 5042 Arc, 999 HyperEVM",
      "enum": [
        1,
        8453,
        42161,
        10,
        4663,
        56,
        137,
        43114,
        130,
        143,
        5042,
        999
      ],
      "type": "integer"
    },
    "token": {
      "description": "Token address on that chain. Use the zero address for the chain's native coin; on Arc, whose native coin is USDC, use its contract 0x3600000000000000000000000000000000000000.",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "type": "string"
    }
  },
  "required": [
    "chainId",
    "token"
  ],
  "additionalProperties": false
}

Every chain LCX Liberty DEX serves, with the live health of its index. Call it to learn which chainId values the other tools accept and whether a chain is quoting right now, or to explain a refused or stale answer from get_quote or get_price. Read-only, takes no arguments, and does not count against the API key's quota. Each entry has chainId, key, name, nativeSymbol, wrappedNative, router (the address a swap approves), ready (fresh enough to build a swap), degraded (still quoting, prices indicative only), available, unavailableReason (why not, when it is not) and ageSeconds, how long since the index recorded a new block, judged against freshnessLimitSeconds.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Reads the calling API key's own plan and usage, so no key or account id is passed. Use it to answer questions about quota or throttling, or before a long run of calls. Read-only, live, and it does not count against the quota. Returns plan and planLabel; callsUsed, monthlyCalls and callsRemaining for the current billing period (monthlyCalls and callsRemaining are null when the plan has no cap); and rateLimit as perSecond and perMinute, where a slow request uses more than one. Only successful calls are counted, and at the limit calls are refused, never billed as overage.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}