AgentData - Executable Liquidity / Exit-Cost

Size-aware exit cost, depeg risk, and liquidity fragility for a token on Base. Given a token and a sell size, returns the realized cost of exiting (price impact + fee, in bps and units), the best route across venues, an aggregated fragility score, and — for pegged assets — a depeg-risk score. Computed deterministically from on-chain AMM state, so the result is reproducible and auditable. Three tiers by compute depth (default 'risk'): 'quote' = best-route exit cost for one size; 'risk' = exit cost + fragility (+ depeg for pegged tokens); 'deep' = adds a multi-size exit-cost curve, max-size-before-cost thresholds, and an internal cross-check. Pricing per call (USDC): quote = $0, risk = $0, deep = $0. Status: testnet/preview — payment runs over the x402 HTTP surface, not this tool.

{
  "type": "object",
  "properties": {
    "token": {
      "description": "Token symbol/address to exit (sell), e.g. 'WETH'.",
      "title": "Token",
      "type": "string"
    },
    "size": {
      "description": "Sell size in human token units (> 0).",
      "exclusiveMinimum": 0,
      "title": "Size",
      "type": "number"
    },
    "tier": {
      "default": "risk",
      "description": "Pricing/compute tier. 'quote' = best-route exit cost only; 'risk' (default) adds fragility + depeg; 'deep' adds a multi-size exit-cost curve and cross-check.",
      "enum": [
        "quote",
        "risk",
        "deep"
      ],
      "title": "Tier",
      "type": "string"
    },
    "pool": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional: restrict the computation to a single pool id.",
      "title": "Pool"
    }
  },
  "required": [
    "token",
    "size"
  ],
  "title": "liquidity_exit_costArguments"
}

{
  "type": "object",
  "properties": {
    "tier": {
      "title": "Tier",
      "type": "string"
    },
    "network": {
      "description": "testnet | mainnet",
      "title": "Network",
      "type": "string"
    },
    "token": {
      "title": "Token",
      "type": "string"
    },
    "size": {
      "title": "Size",
      "type": "number"
    },
    "exit_cost": {
      "$ref": "#/$defs/ExitCostModel"
    },
    "route": {
      "$ref": "#/$defs/RouteModel"
    },
    "fragility": {
      "anyOf": [
        {
          "$ref": "#/$defs/FragilityModel"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "depeg": {
      "anyOf": [
        {
          "$ref": "#/$defs/DepegModel"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "exit_cost_curve": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/$defs/CurvePoint"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Exit Cost Curve"
    },
    "max_size_before_cost": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/$defs/MaxSizeEntry"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Max Size Before Cost"
    },
    "cross_check": {
      "anyOf": [
        {
          "$ref": "#/$defs/CrossCheck"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "tier",
    "network",
    "token",
    "size",
    "exit_cost",
    "route"
  ],
  "$defs": {
    "CrossCheck": {
      "properties": {
        "deepest_pool_id": {
          "title": "Deepest Pool Id",
          "type": "string"
        },
        "deepest_pool_cost_bps": {
          "title": "Deepest Pool Cost Bps",
          "type": "number"
        },
        "best_route_cost_bps": {
          "title": "Best Route Cost Bps",
          "type": "number"
        }
      },
      "required": [
        "deepest_pool_id",
        "deepest_pool_cost_bps",
        "best_route_cost_bps"
      ],
      "title": "CrossCheck",
      "type": "object"
    },
    "CurvePoint": {
      "properties": {
        "size": {
          "description": "Sell size in human token units.",
          "title": "Size",
          "type": "number"
        },
        "amount_out": {
          "description": "Output-token units received (fee incl.).",
          "title": "Amount Out",
          "type": "number"
        },
        "mid_price": {
          "description": "Marginal price (out per 1 in) at size 0.",
          "title": "Mid Price",
          "type": "number"
        },
        "exec_price": {
          "description": "Realized price = amount_out / size.",
          "title": "Exec Price",
          "type": "number"
        },
        "total_cost_bps": {
          "description": "Loss vs mid (fee + slippage), bps.",
          "title": "Total Cost Bps",
          "type": "number"
        },
        "price_impact_bps": {
          "description": "Slippage only (fee excluded), bps.",
          "title": "Price Impact Bps",
          "type": "number"
        },
        "fee_bps": {
          "description": "Pool fee component, bps.",
          "title": "Fee Bps",
          "type": "number"
        },
        "size_multiple": {
          "title": "Size Multiple",
          "type": "number"
        }
      },
      "required": [
        "size",
        "amount_out",
        "mid_price",
        "exec_price",
        "total_cost_bps",
        "price_impact_bps",
        "fee_bps",
        "size_multiple"
      ],
      "title": "CurvePoint",
      "type": "object"
    },
    "DepegModel": {
      "properties": {
        "deviation_bps": {
          "title": "Deviation Bps",
          "type": "number"
        },
        "dispersion_bps": {
          "title": "Dispersion Bps",
          "type": "number"
        },
        "weighted_price": {
          "title": "Weighted Price",
          "type": "number"
        },
        "total_liquidity": {
          "title": "Total Liquidity",
          "type": "number"
        },
        "score": {
          "description": "0..100, higher = more depeg risk.",
          "title": "Score",
          "type": "number"
        }
      },
      "required": [
        "deviation_bps",
        "dispersion_bps",
        "weighted_price",
        "total_liquidity",
        "score"
      ],
      "title": "DepegModel",
      "type": "object"
    },
    "ExitCostModel": {
      "properties": {
        "size": {
          "description": "Sell size in human token units.",
          "title": "Size",
          "type": "number"
        },
        "amount_out": {
          "description": "Output-token units received (fee incl.).",
          "title": "Amount Out",
          "type": "number"
        },
        "mid_price": {
          "description": "Marginal price (out per 1 in) at size 0.",
          "title": "Mid Price",
          "type": "number"
        },
        "exec_price": {
          "description": "Realized price = amount_out / size.",
          "title": "Exec Price",
          "type": "number"
        },
        "total_cost_bps": {
          "description": "Loss vs mid (fee + slippage), bps.",
          "title": "Total Cost Bps",
          "type": "number"
        },
        "price_impact_bps": {
          "description": "Slippage only (fee excluded), bps.",
          "title": "Price Impact Bps",
          "type": "number"
        },
        "fee_bps": {
          "description": "Pool fee component, bps.",
          "title": "Fee Bps",
          "type": "number"
        }
      },
      "required": [
        "size",
        "amount_out",
        "mid_price",
        "exec_price",
        "total_cost_bps",
        "price_impact_bps",
        "fee_bps"
      ],
      "title": "ExitCostModel",
      "type": "object"
    },
    "FragilityModel": {
      "properties": {
        "score": {
          "description": "0..100, higher = more fragile.",
          "title": "Score",
          "type": "number"
        },
        "depth_score": {
          "title": "Depth Score",
          "type": "number"
        },
        "concentration_score": {
          "title": "Concentration Score",
          "type": "number"
        },
        "convexity_score": {
          "title": "Convexity Score",
          "type": "number"
        },
        "total_exit_liquidity": {
          "title": "Total Exit Liquidity",
          "type": "number"
        },
        "venues": {
          "title": "Venues",
          "type": "integer"
        }
      },
      "required": [
        "score",
        "depth_score",
        "concentration_score",
        "convexity_score",
        "total_exit_liquidity",
        "venues"
      ],
      "title": "FragilityModel",
      "type": "object"
    },
    "MaxSizeEntry": {
      "properties": {
        "max_cost_bps": {
          "title": "Max Cost Bps",
          "type": "number"
        },
        "max_size": {
          "title": "Max Size",
          "type": "number"
        }
      },
      "required": [
        "max_cost_bps",
        "max_size"
      ],
      "title": "MaxSizeEntry",
      "type": "object"
    },
    "RouteModel": {
      "properties": {
        "best": {
          "$ref": "#/$defs/ExitCostModel"
        },
        "pool_id": {
          "title": "Pool Id",
          "type": "string"
        },
        "dex": {
          "title": "Dex",
          "type": "string"
        },
        "routed_split": {
          "description": "True if cost is split across venues.",
          "title": "Routed Split",
          "type": "boolean"
        },
        "venues_considered": {
          "title": "Venues Considered",
          "type": "integer"
        }
      },
      "required": [
        "best",
        "pool_id",
        "dex",
        "routed_split",
        "venues_considered"
      ],
      "title": "RouteModel",
      "type": "object"
    }
  },
  "title": "ExitCostResponse"
}