Exit-liquidity and price-trust assessment for a Base ERC-20 token at a requested

Exit-liquidity and price-trust assessment for a Base ERC-20 token at a requested USD position size. On-chain sell quotes cover Aerodrome, Slipstream, and Uniswap V2/V3/V4. Returns tradeable, caution, illiquid, or unverified with executable proceeds, price impact, confidence, concerns, and unmeasured checks. Inputs: token address and size_usd.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

GET https://fathom-api.mioku-fathom.workers.dev/v1/assess

Our checks, last 30 days

Example input (from the provider)

{
  "method": "GET",
  "queryParams": {
    "size_usd": 10000,
    "token": "0x940181a94A35A4569E4529A3CDfB74e38FD98631"
  },
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "additionalProperties": false,
          "properties": {
            "chain": {
              "default": "base",
              "enum": [
                "base"
              ],
              "type": "string"
            },
            "size_usd": {
              "default": 10000,
              "description": "The sale you are contemplating, in USD. Quoted on chain at exactly this size rather than interpolated between standard sizes. Pass the position you actually hold.",
              "maximum": 10000000,
              "minimum": 1,
              "type": "number"
            },
            "token": {
              "description": "Base ERC-20 token address",
              "pattern": "^0x[a-fA-F0-9]{40}$",
              "type": "string"
            }
          },
          "required": [
            "token"
          ],
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "asset_flags": {
              "description": "Machine-readable asset flags. `concerns` and `unverified` carry the subset that belongs in each; a premium appears in neither, because it is an observation about price rather than a risk or a gap in what was measured.",
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "asset_type": {
              "description": "What kind of token this is. `erc20` is every ordinary Base token. `b20_stock` is a verified Coinbase tokenized stock and carries `b20` and `stock_reference`. `b20_asset` is a B20 token Fathom cannot identify as a stock: the factory is permissionless, so being a B20 asset does not make a token an equity.",
              "enum": [
                "erc20",
                "b20_asset",
                "b20_stock"
              ],
              "type": "string"
            },
            "b20": {
              "description": "Asset semantics for a B20 token. Absent for a plain ERC-20.",
              "properties": {
                "corporate_action_pending": {
                  "description": "True while a corporate action is being applied and the equity reference feed is held frozen. null means this could not be established.",
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "effective_at": {
                  "format": "date-time",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "multiplier": {
                  "description": "How many underlying shares one token is redeemable for. One token is NOT permanently one share: dividends and splits move this. null means it could not be read, never 1.0 by default.",
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "next_ui_multiplier": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "paused": {
                  "description": "Transfers paused on chain by the issuer. This blocks a sale outright.",
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "policy_restricted": {
                  "description": "A transfer policy is configured. This does NOT mean the caller is blocked: secondary trading is permissionless and these slots normally hold a sanctions blocklist. Fathom does not know the selling address and so cannot resolve applicability.",
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "ui_multiplier": {
                  "description": "ERC-8056 scheduled-multiplier view. null means the token does not implement it, not that no update is scheduled.",
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "underlying": {
                  "description": "The equity this token represents, for verified stocks only.",
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "underlying",
                "multiplier",
                "corporate_action_pending",
                "paused",
                "policy_restricted"
              ],
              "type": "object"
            },
            "chain": {
              "type": "string"
            },
            "concerns": {
              "description": "Measured facts about the token that argue against trading it. Act on these.",
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "exit": {
              "description": "What the requested sale actually returns, quoted on chain.",
              "properties": {
                "execution_price_usd": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "fillable": {
                  "description": "true if the sale fills, false if measured and it cannot, null if never established. The last is not a negative.",
                  "type": [
                    "boolean",
        

This page as JSON