{"slug":"fathom-api-mioku-fathom-workers-dev-v1-assess-247e0c","title":"Exit-liquidity and price-trust assessment for a Base ERC-20 token at a requested","host":"fathom-api.mioku-fathom.workers.dev","method":"GET","resource":"https://fathom-api.mioku-fathom.workers.dev/v1/assess","category":"market","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","price_listed":0.001,"price_asked":0.001,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":434,"reported_calls_30d":2,"reported_payers_30d":2,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","queryParams":{"size_usd":10000,"token":"0x940181a94A35A4569E4529A3CDfB74e38FD98631"},"type":"http"},"output_schema":{"$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","null"]},"price_impact_bps":{"description":"Shortfall of the realised price against spot.","type":["number","null"]},"proceeds_usd":{"type":["number","null"]}},"required":["fillable","proceeds_usd","price_impact_bps","execution_price_usd"],"type":"object"},"price_trust":{"description":"How well corroborated the price behind that quote is.","properties":{"confidence":{"maximum":100,"minimum":0,"type":"number"},"dispersion_bps":{"type":["number","null"]},"measured_weight":{"description":"Share of the confidence model actually measured.","maximum":1,"minimum":0,"type":"number"},"sources":{"description":"Independent pools that agreed.","type":"number"},"twap_deviation_bps":{"type":["number","null"]}},"required":["confidence","measured_weight","sources","dispersion_bps","twap_deviation_bps"],"type":"object"},"price_usd":{"type":"number"},"reason":{"description":"One sentence saying why, for an agent's trace and for a human reading it.","type":"string"},"size_usd":{"description":"The sale this verdict is about.","type":"number"},"stock_reference":{"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.","properties":{"age_seconds":{"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.","type":["number","null"]},"feed":{"type":["string","null"]},"premium_discount_bps":{"description":"Fathom's measured on-chain price against that reference, in bps. Positive is a premium. null when either side is unavailable.","type":["number","null"]},"reference_price_usd":{"description":"Chainlink total-return value: the price of one TOKEN, already inclusive of the multiplier. Do not multiply it by the multiplier again.","type":["number","null"]},"source":{"enum":["chainlink",null],"type":["string","null"]},"updated_at":{"format":"date-time","type":["string","null"]}},"required":["reference_price_usd","premium_discount_bps","source"],"type":"object"},"symbol":{"type":"string"},"token":{"type":"string"},"unverified":{"description":"Checks that did not run. Never evidence against the token - a failure to look is not a finding.","items":{"type":"string"},"type":"array"},"updated_at":{"format":"date-time","type":"string"},"verdict":{"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.","enum":["tradeable","caution","illiquid","unverified"],"type":"string"}},"required":["token","chain","verdict","reason","size_usd","exit","price_trust","asset_type"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-18","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.001,"price_match":true,"latency_ms":434,"error":null}],"description_full":"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.","last_updated":"2026-10-18T10:40:06.165Z","schemes":["exact"]}