{"uid":"cap_0rUABfAqUIGCSvS6j1Cne","slug":"fathom-token-exit-assessment-29fa0240","name":"Fathom Token Exit Assessment","description":"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.","url":"https://fathom-api.mioku-fathom.workers.dev/v1/assess?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["token"],"properties":{"chain":{"enum":["base"],"type":"string","default":"base"},"token":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Base ERC-20 token address"},"size_usd":{"type":"number","default":10000,"maximum":10000000,"minimum":1,"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."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["token","chain","verdict","reason","size_usd","exit","price_trust","asset_type"],"properties":{"b20":{"type":"object","required":["underlying","multiplier","corporate_action_pending","paused","policy_restricted"],"properties":{"paused":{"type":["boolean","null"],"description":"Transfers paused on chain by the issuer. This blocks a sale outright."},"multiplier":{"type":["number","null"],"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."},"underlying":{"type":["string","null"],"description":"The equity this token represents, for verified stocks only."},"effective_at":{"type":["string","null"],"format":"date-time"},"ui_multiplier":{"type":["number","null"],"description":"ERC-8056 scheduled-multiplier view. null means the token does not implement it, not that no update is scheduled."},"policy_restricted":{"type":["boolean","null"],"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."},"next_ui_multiplier":{"type":["number","null"]},"corporate_action_pending":{"type":["boolean","null"],"description":"True while a corporate action is being applied and the equity reference feed is held frozen. null means this could not be established."}},"description":"Asset semantics for a B20 token. Absent for a plain ERC-20."},"exit":{"type":"object","required":["fillable","proceeds_usd","price_impact_bps","execution_price_usd"],"properties":{"fillable":{"type":["boolean","null"],"description":"true if the sale fills, false if measured and it cannot, null if never established. The last is not a negative."},"proceeds_usd":{"type":["number","null"]},"price_impact_bps":{"type":["number","null"],"description":"Shortfall of the realised price against spot."},"execution_price_usd":{"type":["number","null"]}},"description":"What the requested sale actually returns, quoted on chain."},"chain":{"type":"string"},"token":{"type":"string"},"reason":{"type":"string","description":"One sentence saying why, for an agent's trace and for a human reading it."},"symbol":{"type":"string"},"verdict":{"enum":["tradeable","caution","illiquid","unverified"],"type":"string","description":"The single field to branch on. `tradeable`: the sale fills cheaply against a corroborated price. `caution`: it fills, at a cost worth knowing. `illiquid`: it cannot be filled, or costs over a tenth of the position. `unverified`: too little could be measured to say - retry rather than treating this as a negative."},"concerns":{"type":"array","items":{"type":"string"},"description":"Measured facts about the token that argue against trading it. Act on these."},"size_usd":{"type":"number","description":"The sale this verdict is about."},"price_usd":{"type":"number"},"asset_type":{"enum":["erc20","b20_asset","b20_stock"],"type":"string","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."},"unverified":{"type":"array","items":{"type":"string"},"description":"Checks that did not run. Never evidence against the token - a failure to look is not a finding."},"updated_at":{"type":"string","format":"date-time"},"asset_flags":{"type":"array","items":{"type":"string"},"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."},"price_trust":{"type":"object","required":["confidence","measured_weight","sources","dispersion_bps","twap_deviation_bps"],"properties":{"sources":{"type":"number","description":"Independent pools that agreed."},"confidence":{"type":"number","maximum":100,"minimum":0},"dispersion_bps":{"type":["number","null"]},"measured_weight":{"type":"number","maximum":1,"minimum":0,"description":"Share of the confidence model actually measured."},"twap_deviation_bps":{"type":["number","null"]}},"description":"How well corroborated the price behind that quote is."},"stock_reference":{"type":"object","required":["reference_price_usd","premium_discount_bps","source"],"properties":{"feed":{"type":["string","null"]},"source":{"enum":["chainlink",null],"type":["string","null"]},"updated_at":{"type":["string","null"],"format":"date-time"},"age_seconds":{"type":["number","null"],"description":"How long the feed has held its value. Outside US market hours it stops updating by design, so a large age means the equity market is shut, not that anything is wrong."},"reference_price_usd":{"type":["number","null"],"description":"Chainlink total-return value: the price of one TOKEN, already inclusive of the multiplier. Do not multiply it by the multiplier again."},"premium_discount_bps":{"type":["number","null"],"description":"Fathom's measured on-chain price against that reference, in bps. Positive is a premium. null when either side is unavailable."}},"description":"The equity reference for a verified Coinbase tokenized stock. Never a substitute for `exit`, which remains the only field that says what a sale returns."}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_OxNUjNOxit56KqJaqOynI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Assesses exit liquidity and price trust for a Base ERC-20 token at a specified USD position size, returning a verdict (tradeable/caution/illiquid/unverified) with executable proceeds, price impact, and confidence metrics across Aerodrome, Slipstream, and Uniswap V2/V3/V4.","exampleAgentPrompt":"Can you assess my exit liquidity for token 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed on Base — I'm thinking of selling a $25,000 position and want to know if I'll get a good price or if there's too much slippage.","exampleUseCases":[{"title":"Pre-sale liquidity check for whale position","prompt":"Before I sell my $200,000 position in token 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base, can you assess whether the market can actually absorb that size without wrecking the price? I want to see the verdict, estimated proceeds, and price impact."},{"title":"DeFi portfolio exit risk screening","prompt":"I'm reviewing my Base wallet holdings. For token 0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22, run a liquidity assessment at a $5,000 sale size and tell me if it's flagged as tradeable, caution, illiquid, or unverified."},{"title":"Automated sell-signal validation","prompt":"My trading bot just triggered a sell signal on token 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb on Base for a $15,000 position. Before executing, assess the exit liquidity and price trust so I know if the on-chain conditions actually support the trade."}],"resultDescription":"Returns a structured assessment including: a verdict label (tradeable, caution, illiquid, or unverified), executable proceeds in USD, price impact percentage, confidence score, a reason summary, price_trust rating, list of concerns or risk flags, asset_type, and notes on unmeasured checks. For tokenized equity (b20) tokens, may also include underlying stock, multiplier, paused status, and policy restrictions.","failureModes":["Invalid token address format (must be 0x-prefixed 40-char hex) returns validation error","Token not found on Base chain returns unverified verdict","size_usd outside allowed range (1–10,000,000) rejected","No liquidity found on any supported DEX returns illiquid verdict","On-chain RPC errors may cause partial or failed quotes","Payment failure via x402 protocol blocks request"],"whenToPreferThis":"Use this endpoint when you need a real on-chain sell quote at a specific USD position size on Base, aggregated across Aerodrome, Slippage, and Uniswap V2/V3/V4 — not an interpolated estimate. It is especially valuable before executing large exits where slippage and liquidity depth matter, or when you need a trustworthiness signal (price_trust) alongside the quote. Prefer it over generic price feeds when you need executable confidence rather than spot price.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T12:31:08.056Z","isFirstParty":false,"canonicalSlug":"fathom-token-exit-assessment-29fa0240"}