{
  "$schema": "https://degreesofsatoshi.com/encyclopedia/schemas/article-v1.json",
  "schemaVersion": "1.0.0",
  "id": "insufficient-dex-liquidity",
  "canonical": "https://degreesofsatoshi.com/encyclopedia/insufficient-dex-liquidity/",
  "collection": "defi",
  "title": "Insufficient DEX liquidity: no route, poor quote or unavailable inventory?",
  "description": "Diagnose missing or weak swap routes by distinguishing supported assets, active inventory and executable size.",
  "aliases": [
    "insufficient liquidity for this trade",
    "not enough liquidity to swap token"
  ],
  "dates": {
    "published": "2026-10-02",
    "modified": "2026-10-02",
    "verified": "2026-10-02T19:18:00.092Z",
    "dataAsOf": "2026-10-02"
  },
  "authorship": {
    "publisher": "Degrees of Satoshi editorial project",
    "process": "AI-assisted research and drafting with a separate automated source-verification pass; no external expert or named human review is implied."
  },
  "quickAnswer": {
    "text": "An insufficient-liquidity message can mean the selected service cannot find a usable route, the available inventory cannot support the requested size within its limits, or the token is incompatible with that execution path. A token’s market capitalization or total pool value does not establish liquidity at the price and route you need.",
    "claimId": "insufficient-dex-liquidity-quick-answer",
    "sourceIds": [
      "x425-defi-uni-range",
      "x425-defi-uni-swaps",
      "x425-defi-uniswap-security"
    ]
  },
  "keyFacts": [
    {
      "label": "Active range",
      "value": "Concentrated liquidity outside the current range is inactive.",
      "sourceIds": [
        "x425-defi-uni-range"
      ],
      "id": "active-range",
      "claimId": "insufficient-dex-liquidity-fact-active-range"
    },
    {
      "label": "Trade size",
      "value": "A route must satisfy the actual input/output limits.",
      "sourceIds": [
        "x425-defi-uni-swaps"
      ],
      "id": "trade-size",
      "claimId": "insufficient-dex-liquidity-fact-trade-size"
    },
    {
      "label": "Token behavior",
      "value": "Nonstandard transfers and rebasing can create integration limitations.",
      "sourceIds": [
        "x425-defi-uniswap-security"
      ],
      "id": "token-behavior",
      "claimId": "insufficient-dex-liquidity-fact-token-behavior"
    }
  ],
  "prerequisites": [
    "swap-routing-and-aggregators"
  ],
  "sections": [
    {
      "id": "identify",
      "heading": "Start with the exact market",
      "sourceIds": [
        "x425-defi-uni-factory",
        "x425-defi-uni-swaps"
      ],
      "paragraphs": [
        "Identify the network and both token contracts, then the pool or route used by the interface. A pool for the same ticker on another network is separate inventory. In v3, even the same pair can have multiple fee-tier pools.",
        "A missing interface route is not proof that no trade anywhere is possible. It is evidence about that service’s supported paths at that moment."
      ]
    },
    {
      "id": "size",
      "heading": "Depth is specific to the trade",
      "sourceIds": [
        "x425-defi-uni-range",
        "x425-defi-uni-swaps"
      ],
      "paragraphs": [
        "Suppose a pool displays one million dollars of total assets, but most concentrated positions sit far from the current price. The usable inventory around today’s price can be much smaller. A tiny quote and a large quote need not have similar average rates.",
        "Reducing a hypothetical order from 1,000 tokens to 10 is a diagnostic comparison of size, not proof that repeated small trades eliminate aggregate price impact. Each trade changes the remaining inventory."
      ]
    },
    {
      "id": "limits",
      "heading": "Avoid treating a looser limit as new liquidity",
      "sourceIds": [
        "x425-defi-uni-swaps",
        "x425-defi-uniswap-security"
      ],
      "paragraphs": [
        "Raising slippage tolerance permits a worse outcome; it does not create inventory or repair a token whose transfers fail. Compare a new route’s output and token behavior before interpreting an error as merely an overly strict tolerance. An executable quote can still be economically poor."
      ]
    }
  ],
  "faq": [
    {
      "question": "Does a large holder count prove a token is easy to sell?",
      "answer": "No. Holder count is not active pool inventory, nor does it demonstrate that transfers and swaps are unrestricted. Examine the exact route and token behavior.",
      "sourceIds": [
        "x425-defi-uni-range",
        "x425-defi-uniswap-security"
      ]
    }
  ],
  "claims": [
    {
      "id": "insufficient-dex-liquidity-quick-answer",
      "articleSlug": "insufficient-dex-liquidity",
      "statement": "An insufficient-liquidity message can mean the selected service cannot find a usable route, the available inventory cannot support the requested size within its limits, or the token is incompatible with that execution path. A token’s market capitalization or total pool value does not establish liquidity at the price and route you need.",
      "sourceIds": [
        "source-30d257b4fb4b7c1f",
        "source-30ee786187b1a90d",
        "source-1dfb73e432851474"
      ],
      "sourceLocators": [
        {
          "sourceId": "source-30d257b4fb4b7c1f",
          "locator": "Active liquidity; ticks"
        },
        {
          "sourceId": "source-30ee786187b1a90d",
          "locator": "exactInputSingle; exactOutputSingle; deadline; amountOutMinimum; amountInMaximum"
        },
        {
          "sourceId": "source-1dfb73e432851474",
          "locator": "Nonstandard token behavior; rebasing; fees"
        }
      ],
      "scope": {
        "collection": "defi",
        "dataAsOf": "2026-10-02",
        "blockHeight": null
      },
      "qualification": "",
      "evidenceStatus": "documented",
      "verification": {
        "status": "verified",
        "method": "independent automated source review",
        "checkedAt": "2026-10-02T19:18:00.092Z",
        "reviewer": "Independent automated verification — Codex root, separate from the DeFi drafting agent",
        "notes": [
          "Checked active concentrated liquidity and price range boundaries; thin depth does not prove a token contract transfer failure."
        ]
      }
    },
    {
      "id": "insufficient-dex-liquidity-fact-active-range",
      "articleSlug": "insufficient-dex-liquidity",
      "statement": "Active range: Concentrated liquidity outside the current range is inactive.",
      "sourceIds": [
        "source-30d257b4fb4b7c1f"
      ],
      "sourceLocators": [
        {
          "sourceId": "source-30d257b4fb4b7c1f",
          "locator": "Active liquidity; ticks"
        }
      ],
      "scope": {
        "collection": "defi",
        "dataAsOf": "2026-10-02",
        "blockHeight": null
      },
      "qualification": "",
      "evidenceStatus": "documented",
      "verification": {
        "status": "verified",
        "method": "independent automated source review",
        "checkedAt": "2026-10-02T19:18:00.092Z",
        "reviewer": "Independent automated verification — Codex root, separate from the DeFi drafting agent",
        "notes": [
          "Checked active concentrated liquidity and price range boundaries; thin depth does not prove a token contract transfer failure."
        ]
      }
    },
    {
      "id": "insufficient-dex-liquidity-fact-trade-size",
      "articleSlug": "insufficient-dex-liquidity",
      "statement": "Trade size: A route must satisfy the actual input/output limits.",
      "sourceIds": [
        "source-30ee786187b1a90d"
      ],
      "sourceLocators": [
        {
          "sourceId": "source-30ee786187b1a90d",
          "locator": "exactInputSingle; exactOutputSingle; deadline; amountOutMinimum; amountInMaximum"
        }
      ],
      "scope": {
        "collection": "defi",
        "dataAsOf": "2026-10-02",
        "blockHeight": null
      },
      "qualification": "",
      "evidenceStatus": "documented",
      "verification": {
        "status": "verified",
        "method": "independent automated source review",
        "checkedAt": "2026-10-02T19:18:00.092Z",
        "reviewer": "Independent automated verification — Codex root, separate from the DeFi drafting agent",
        "notes": [
          "Checked active concentrated liquidity and price range boundaries; thin depth does not prove a token contract transfer failure."
        ]
      }
    },
    {
      "id": "insufficient-dex-liquidity-fact-token-behavior",
      "articleSlug": "insufficient-dex-liquidity",
      "statement": "Token behavior: Nonstandard transfers and rebasing can create integration limitations.",
      "sourceIds": [
        "source-1dfb73e432851474"
      ],
      "sourceLocators": [
        {
          "sourceId": "source-1dfb73e432851474",
          "locator": "Nonstandard token behavior; rebasing; fees"
        }
      ],
      "scope": {
        "collection": "defi",
        "dataAsOf": "2026-10-02",
        "blockHeight": null
      },
      "qualification": "",
      "evidenceStatus": "documented",
      "verification": {
        "status": "verified",
        "method": "independent automated source review",
        "checkedAt": "2026-10-02T19:18:00.092Z",
        "reviewer": "Independent automated verification — Codex root, separate from the DeFi drafting agent",
        "notes": [
          "Checked active concentrated liquidity and price range boundaries; thin depth does not prove a token contract transfer failure."
        ]
      }
    }
  ],
  "sources": [
    {
      "id": "x425-defi-uni-range",
      "label": "Concentrated Liquidity",
      "publisher": "Uniswap",
      "url": "https://docs.uniswap.org/concepts/protocol/concentrated-liquidity",
      "locator": "Active liquidity; ticks",
      "note": "Active range, inventory changes and fee earning.",
      "version": "Documentation retrieved for the 2026-10-02 editorial scope; content hash recorded",
      "checkedAt": "2026-10-02T18:53:19.537Z",
      "contentSha256": "895e660a97de0f51f8d13a973cc1b11bec89cbbd156cd87ff09685dc7afddccb",
      "recordId": "source-30d257b4fb4b7c1f"
    },
    {
      "id": "x425-defi-uni-swaps",
      "label": "Single Swaps",
      "publisher": "Uniswap",
      "url": "https://docs.uniswap.org/contracts/v3/guides/swaps/single-swaps",
      "locator": "exactInputSingle; exactOutputSingle; deadline; amountOutMinimum; amountInMaximum",
      "note": "Version-specific router constraints and worked integration examples.",
      "version": "Documentation retrieved for the 2026-10-02 editorial scope; content hash recorded",
      "checkedAt": "2026-10-02T18:53:19.662Z",
      "contentSha256": "34d9c27db51d7c364e5a5c0a8c93361d78a771368eec5079bea7fd709475489c",
      "recordId": "source-30ee786187b1a90d"
    },
    {
      "id": "x425-defi-uniswap-security",
      "label": "Token Integration Issues",
      "publisher": "Uniswap",
      "url": "https://docs.uniswap.org/concepts/protocol/integration-issues",
      "locator": "Nonstandard token behavior; rebasing; fees",
      "note": "Token code can alter pool integration behavior even when liquidity exists.",
      "version": "Documentation retrieved for the 2026-10-02 editorial scope; content hash recorded",
      "checkedAt": "2026-10-02T18:53:23.402Z",
      "contentSha256": "1a009ddb8e66f122a95438ab276d91337fbfa9644b3c169cdf7352ad3ae7f853",
      "recordId": "source-1dfb73e432851474"
    },
    {
      "id": "x425-defi-uni-factory",
      "label": "Uniswap v3 protocol architecture",
      "publisher": "Uniswap",
      "url": "https://docs.uniswap.org/contracts/v3/reference/core/UniswapV3Factory",
      "locator": "uniswap-v3-core / Factory paragraph in the redirected v3 contracts overview",
      "note": "Factory deploys pools for a token pair and fee; network identification remains necessary.",
      "version": "Documentation retrieved for the 2026-10-02 editorial scope; content hash recorded",
      "checkedAt": "2026-10-02T18:53:20.189Z",
      "contentSha256": "78f9870e23fdf57e3285daaa42f31ed38a7639485b1f050270dcb3db97a0c4d4",
      "recordId": "source-1abf5b1626a79b4b"
    }
  ],
  "related": {
    "articles": [
      "identifying-dex-pools",
      "slippage-and-price-impact",
      "defi-tvl",
      "swap-deadlines-expired-quotes"
    ],
    "dossiers": [],
    "wallets": []
  },
  "revisionHistory": [
    {
      "date": "2026-10-02",
      "kind": "published",
      "summary": "First publication after primary-source research and separate automated verification."
    }
  ],
  "citation": "Degrees of Satoshi editorial project. “Insufficient DEX liquidity: no route, poor quote or unavailable inventory?.” Published 2026-10-02; updated 2026-10-02. https://degreesofsatoshi.com/encyclopedia/insufficient-dex-liquidity/"
}
