Live LP analytics — Uniswap V2/V3, Balancer, Curve stableswap: PnL, health, slippage, depeg risk.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Analyze a 2-asset Balancer weighted-pool LP position's PnL. Decomposes impermanent loss using the weighted-pool formula where the base token's weight affects IL magnitude. Values are denominated in opp-token units per BalancerImpLoss's convention; fee income is not attributed in v1 because Balancer pools only expose vault-level fees with no per-LP attribution.
An Ethereum (or L2) JSON-RPC URL used to read live pool state. Required; supplied by you per call (BYO-RPC) and may carry your provider key. The endpoint stores and logs nothing — the URL is never persisted or written to logs.
Which protocol the pool at pool_address belongs to. This tool accepts only balancer (2-asset weighted pool).
Pool shares held by this position, in human units.
On-chain address of the pool/pair to analyze (Uniswap V2/V3 pair, Balancer weighted pool, or Curve stableswap pool). Required. Lowercase, uppercase, or checksum casing all work.
Amount of opp (second) token originally deposited.
Amount of base (first) token originally deposited.
Optional guard. If supplied and the RPC reports a different chain id, the call is rejected. Defaults to 1 (Ethereum mainnet) conceptually; omit to skip the check.
Optional block number to pin the read to a historical block. Omit to read the latest block.
Optional holding period in days. If supplied, real_apr is annualized from net_pnl.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Analyze a 2-asset Balancer weighted-pool LP position's PnL. Decomposes impermanent loss using the weighted-pool formula where the base token's weight affects IL magnitude. Values are denominated in opp-token units per BalancerImpLoss's convention; fee income is not attributed in v1 because Balancer pools only expose vault-level fees with no per-LP attribution.
| Argument | Type | Description |
|---|---|---|
| rpc_url* | string | An Ethereum (or L2) JSON-RPC URL used to read live pool state. Required; supplied by you per call (BYO-RPC) and may carry your provider key. The endpoint stores and logs nothing — the URL is never persisted or written to logs. |
| chain_id | integer | Optional guard. If supplied and the RPC reports a different chain id, the call is rejected. Defaults to 1 (Ethereum mainnet) conceptually; omit to skip the check. |
| pool_type* | string | Which protocol the pool at pool_address belongs to. This tool accepts only balancer (2-asset weighted pool). |
| lp_init_amt* | number | Pool shares held by this position, in human units. |
| block_number | integer | Optional block number to pin the read to a historical block. Omit to read the latest block. |
| pool_address* | string | On-chain address of the pool/pair to analyze (Uniswap V2/V3 pair, Balancer weighted pool, or Curve stableswap pool). Required. Lowercase, uppercase, or checksum casing all work. |
| entry_opp_amt* | number | Amount of opp (second) token originally deposited. |
| entry_base_amt* | number | Amount of base (first) token originally deposited. |
| holding_period_days | number | null | Optional holding period in days. If supplied, real_apr is annualized from net_pnl. |
{
"type": "object",
"required": [
"lp_init_amt",
"entry_base_amt",
"entry_opp_amt",
"pool_address",
"rpc_url",
"pool_type"
],
"properties": {
"rpc_url": {
"type": "string",
"description": "An Ethereum (or L2) JSON-RPC URL used to read live pool state. Required; supplied by you per call (BYO-RPC) and may carry your provider key. The endpoint stores and logs nothing — the URL is never persisted or written to logs."
},
"chain_id": {
"type": "integer",
"description": "Optional guard. If supplied and the RPC reports a different chain id, the call is rejected. Defaults to 1 (Ethereum mainnet) conceptually; omit to skip the check."
},
"pool_type": {
"enum": [
"balancer"
],
"type": "string",
"description": "Which protocol the pool at pool_address belongs to. This tool accepts only balancer (2-asset weighted pool)."
},
"lp_init_amt": {
"type": "number",
"description": "Pool shares held by this position, in human units."
},
"block_number": {
"type": "integer",
"description": "Optional block number to pin the read to a historical block. Omit to read the latest block."
},
"pool_address": {
"type": "string",
"description": "On-chain address of the pool/pair to analyze (Uniswap V2/V3 pair, Balancer weighted pool, or Curve stableswap pool). Required. Lowercase, uppercase, or checksum casing all work."
},
"entry_opp_amt": {
"type": "number",
"description": "Amount of opp (second) token originally deposited."
},
"entry_base_amt": {
"type": "number",
"description": "Amount of base (first) token originally deposited."
},
"holding_period_days": {
"type": [
"number",
"null"
],
"description": "Optional holding period in days. If supplied, real_apr is annualized from net_pnl."
}
}
}Analyze why a Uniswap V2 or V3 LP position is gaining or losing money. Decomposes PnL into impermanent loss, accumulated fees, and net result, with optional real APR if a holding period is supplied. Returns current value, hold value, IL percentage, fee income, net PnL, real APR, and a diagnosis label.
| Argument | Type | Description |
|---|---|---|
| rpc_url* | string | An Ethereum (or L2) JSON-RPC URL used to read live pool state. Required; supplied by you per call (BYO-RPC) and may carry your provider key. The endpoint stores and logs nothing — the URL is never persisted or written to logs. |
| chain_id | integer | Optional guard. If supplied and the RPC reports a different chain id, the call is rejected. Defaults to 1 (Ethereum mainnet) conceptually; omit to skip the check. |
| lwr_tick | integer | null | Lower tick of the position (V3 positions only; null for V2). |
| upr_tick | integer | null | Upper tick of the position (V3 positions only; null for V2). |
| pool_type* | string | Which protocol the pool at pool_address belongs to. This tool accepts uniswap_v2 | uniswap_v3. |
| entry_x_amt* | number | Amount of token0 originally deposited at position entry. |
| entry_y_amt* |
Analyze a 2-asset Curve-style Stableswap LP position's PnL using the amplified-invariant IL formula where small depegs can produce surprisingly large IL at high A. Values are in peg-numeraire (tokens valued 1:1); fee income is not attributed in v1 (pool-global only); positions whose implied alpha is in the unreachable regime return None on il_percentage, net_pnl, and real_apr.
| Argument | Type | Description |
|---|---|---|
| rpc_url* | string | An Ethereum (or L2) JSON-RPC URL used to read live pool state. Required; supplied by you per call (BYO-RPC) and may carry your provider key. The endpoint stores and logs nothing — the URL is never persisted or written to logs. |
| chain_id | integer | Optional guard. If supplied and the RPC reports a different chain id, the call is rejected. Defaults to 1 (Ethereum mainnet) conceptually; omit to skip the check. |
| pool_type* | string | Which protocol the pool at pool_address belongs to. This tool accepts only stableswap (2-asset plain Curve pool). |
| lp_init_amt* | number | LP tokens held by this position, in human units. |
| block_number | integer | Optional block number to pin the read to a historical block. Omit to read the latest block. |
| pool_address* | string | On-chain address of the pool/pair to analyze (Uniswap V2/V3 pair, Balancer weighted pool, or Curve stableswap pool). Required. Lowercase, uppercase, or checksum casing all work. |
Quantify a 2-asset Curve-style Stableswap LP position's exposure to a stablecoin depeg. Computes IL at multiple depeg levels (default 2%, 5%, 10%, 20%, 50%) via the closed-form stableswap-invariant expansion, with an optional V2 constant-product benchmark at each level. Some depeg levels are physically unreachable at high A — unreachable scenarios return null on il_pct, lp_value_at_depeg, and hold_value_at_depeg; the V2 benchmark stays populated.
| Argument | Type | Description |
|---|---|---|
| rpc_url* | string | An Ethereum (or L2) JSON-RPC URL used to read live pool state. Required; supplied by you per call (BYO-RPC) and may carry your provider key. The endpoint stores and logs nothing — the URL is never persisted or written to logs. |
| chain_id | integer | Optional guard. If supplied and the RPC reports a different chain id, the call is rejected. Defaults to 1 (Ethereum mainnet) conceptually; omit to skip the check. |
| pool_type* | string | Which protocol the pool at pool_address belongs to. This tool accepts only stableswap (2-asset plain Curve pool). |
| compare_v2 | boolean | null | If true (default), each scenario reports the equivalent V2 constant-product IL at the same price deviation. |
| lp_init_amt* | number | LP tokens held, in human units. Must be > 0. |
| block_number | integer | Optional block number to pin the read to a historical block. Omit to read the latest block. |
Read a pool's on-chain state once and return it as a serialized State Twin (JSON): the protocol-specific snapshot plus a content_hash, in the wire form a client rehydrates locally. Use this to pull a single managed-RPC twin, then run any number of counterfactuals (price moves, IL, slippage) client-side, off this server. Covers Uniswap V2/V3, Balancer 2-asset weighted, and Curve 2-asset plain stableswap pools. The endpoint stores and logs nothing — your rpc_url is never persisted.
| Argument | Type | Description |
|---|---|---|
| rpc_url* | string | An Ethereum (or L2) JSON-RPC URL used to read live pool state. Required; supplied by you per call (BYO-RPC) and may carry your provider key. The endpoint stores and logs nothing — the URL is never persisted or written to logs. |
| chain_id | integer | Optional guard. If supplied and the RPC reports a different chain id, the call is rejected. Omit to skip the check. |
| lwr_tick | integer | uniswap_v3 only — lower tick of the position range to snapshot. Omit for the pool's full active-liquidity range. Ignored for other pool types. |
| upr_tick | integer | uniswap_v3 only — upper tick of the position range to snapshot. Omit for the pool's full active-liquidity range. Ignored for other pool types. |
| pool_type* | string | Which protocol the pool at pool_address belongs to: 'uniswap_v2' | 'uniswap_v3' | 'balancer' (2-asset weighted) | 'stableswap' (2-asset plain Curve). All four are supported — this tool spans every snapshot type. |
Calculate slippage and price-impact decomposition for a proposed swap on a Uniswap V2 or V3 pool. Returns spot vs execution price, slippage percentage, slippage cost in output-token units, and price impact. Also returns the maximum trade size that stays within 1% slippage for V2 pools; V3 returns null for that field because tick-crossing math has not yet been inverted.
| Argument | Type | Description |
|---|---|---|
| rpc_url* | string | An Ethereum (or L2) JSON-RPC URL used to read live pool state. Required; supplied by you per call (BYO-RPC) and may carry your provider key. The endpoint stores and logs nothing — the URL is never persisted or written to logs. |
| chain_id | integer | Optional guard. If supplied and the RPC reports a different chain id, the call is rejected. Defaults to 1 (Ethereum mainnet) conceptually; omit to skip the check. |
| lwr_tick | integer | null | Lower tick of the position (V3 only; null for V2). |
| upr_tick | integer | null | Upper tick of the position (V3 only; null for V2). |
| amount_in | number | Amount of token_in to trade, in human units. Must be > 0. |
| pool_type* | string | Which protocol the pool at pool_address belongs to. This tool accepts uniswap_v2 | uniswap_v3. |
| amounts_in | array |
Snapshot pool-level health metrics for a Uniswap V2 or V3 pool: TVL in token0 numeraire, reserves, accumulated fees, LP concentration, and swap activity. Answers 'is this a pool I would deposit into?' at the pool level (not position level). num_swaps and fee_accrual_rate_recent are V2-only; V3 returns null for these because V3 has no per-swap history array. A single-block live snapshot also returns null for the LP-concentration and swap metrics (unrecoverable from state alone).
| Argument | Type | Description |
|---|---|---|
| rpc_url* | string | An Ethereum (or L2) JSON-RPC URL used to read live pool state. Required; supplied by you per call (BYO-RPC) and may carry your provider key. The endpoint stores and logs nothing — the URL is never persisted or written to logs. |
| chain_id | integer | Optional guard. If supplied and the RPC reports a different chain id, the call is rejected. Defaults to 1 (Ethereum mainnet) conceptually; omit to skip the check. |
| pool_type* | string | Which protocol the pool at pool_address belongs to. This tool accepts uniswap_v2 | uniswap_v3. |
| block_number | integer | Optional block number to pin the read to a historical block. Omit to read the latest block. |
| pool_address* | string | On-chain address of the pool/pair to analyze (Uniswap V2/V3 pair, Balancer weighted pool, or Curve stableswap pool). Required. Lowercase, uppercase, or checksum casing all work. |
| recent_window |
Detect rug-pull signals on a Uniswap V2 or V3 pool via three threshold checks: suspiciously low TVL, top-LP concentration above a limit, and inactive-pool-with-liquidity. Composes over CheckPoolHealth and returns per-signal booleans plus a count-based risk level (low/medium/high/critical). The inactive-with-liquidity signal is V2-only; V3 pools report False for it with a note in details.
| Argument | Type | Description |
|---|---|---|
| rpc_url* | string | An Ethereum (or L2) JSON-RPC URL used to read live pool state. Required; supplied by you per call (BYO-RPC) and may carry your provider key. The endpoint stores and logs nothing — the URL is never persisted or written to logs. |
| chain_id | integer | Optional guard. If supplied and the RPC reports a different chain id, the call is rejected. Defaults to 1 (Ethereum mainnet) conceptually; omit to skip the check. |
| pool_type* | string | Which protocol the pool at pool_address belongs to. This tool accepts uniswap_v2 | uniswap_v3. |
| tvl_floor | number | null | Minimum acceptable TVL in token0 numeraire. Values at or below fire the tvl_suspiciously_low signal. Default 10.0 is nominal; override for your pair. |
| block_number | integer | Optional block number to pin the read to a historical block. Omit to read the latest block. |
| pool_address* | string | On-chain address of the pool/pair to analyze (Uniswap V2/V3 pair, Balancer weighted pool, or Curve stableswap pool). Required. Lowercase, uppercase, or checksum casing all work. |
Project a 2-asset Balancer weighted-pool LP position's value at a hypothetical price change from the CURRENT pool state. The shock is applied to the base-token price in opp units; IL depends on both the shock magnitude and the pool's weights. Returns new value in opp-numeraire, IL at the simulated price, and percentage change.
| Argument | Type | Description |
|---|---|---|
| rpc_url* | string | An Ethereum (or L2) JSON-RPC URL used to read live pool state. Required; supplied by you per call (BYO-RPC) and may carry your provider key. The endpoint stores and logs nothing — the URL is never persisted or written to logs. |
| chain_id | integer | Optional guard. If supplied and the RPC reports a different chain id, the call is rejected. Defaults to 1 (Ethereum mainnet) conceptually; omit to skip the check. |
| pool_type* | string | Which protocol the pool at pool_address belongs to. This tool accepts only balancer (2-asset weighted pool). |
| lp_init_amt* | number | Pool shares held by this position, in human units. Must be > 0. |
| block_number | integer | Optional block number to pin the read to a historical block. Omit to read the latest block. |
| pool_address* | string | On-chain address of the pool/pair to analyze (Uniswap V2/V3 pair, Balancer weighted pool, or Curve stableswap pool). Required. Lowercase, uppercase, or checksum casing all work. |
Project a Uniswap V2 or V3 LP position's value at a hypothetical price change from the CURRENT pool state (not from entry). A price_change_pct of -0.30 asks 'what if price drops 30% from here'. Returns new value, IL at the simulated price, and percentage change in position value. Fee projection is not modeled (always null).
| Argument | Type | Description |
|---|---|---|
| rpc_url* | string | An Ethereum (or L2) JSON-RPC URL used to read live pool state. Required; supplied by you per call (BYO-RPC) and may carry your provider key. The endpoint stores and logs nothing — the URL is never persisted or written to logs. |
| chain_id | integer | Optional guard. If supplied and the RPC reports a different chain id, the call is rejected. Defaults to 1 (Ethereum mainnet) conceptually; omit to skip the check. |
| lwr_tick | integer | null | Lower tick of the position (V3 only; null for V2). |
| upr_tick | integer | null | Upper tick of the position (V3 only; null for V2). |
| pool_type* | string | Which protocol the pool at pool_address belongs to. This tool accepts uniswap_v2 | uniswap_v3. |
| block_number | integer | Optional block number to pin the read to a historical block. Omit to read the latest block. |
| pool_address* |
Project a 2-asset Curve-style Stableswap LP position's value at a hypothetical depeg from the CURRENT pool state. The shock multiplies the pool's current alpha by (1 + price_change_pct); at high A, large shocks may be physically unreachable and in that case new_value, il_at_new_price, and value_change_pct are returned as null. Values are in peg-numeraire.
| Argument | Type | Description |
|---|---|---|
| rpc_url* | string | An Ethereum (or L2) JSON-RPC URL used to read live pool state. Required; supplied by you per call (BYO-RPC) and may carry your provider key. The endpoint stores and logs nothing — the URL is never persisted or written to logs. |
| chain_id | integer | Optional guard. If supplied and the RPC reports a different chain id, the call is rejected. Defaults to 1 (Ethereum mainnet) conceptually; omit to skip the check. |
| pool_type* | string | Which protocol the pool at pool_address belongs to. This tool accepts only stableswap (2-asset plain Curve pool). |
| lp_init_amt* | number | LP tokens held by this position, in human units. Must be > 0. |
| block_number | integer | Optional block number to pin the read to a historical block. Omit to read the latest block. |
| pool_address* | string | On-chain address of the pool/pair to analyze (Uniswap V2/V3 pair, Balancer weighted pool, or Curve stableswap pool). Required. Lowercase, uppercase, or checksum casing all work. |
| number |
| Amount of token1 originally deposited at position entry. |
| lp_init_amt* | number | LP token amount held by the position (position size in human units). |
| block_number | integer | Optional block number to pin the read to a historical block. Omit to read the latest block. |
| pool_address* | string | On-chain address of the pool/pair to analyze (Uniswap V2/V3 pair, Balancer weighted pool, or Curve stableswap pool). Required. Lowercase, uppercase, or checksum casing all work. |
| holding_period_days | number | null | Optional holding period in days. If supplied, real_apr is annualized from net_pnl. |
{
"type": "object",
"required": [
"lp_init_amt",
"entry_x_amt",
"entry_y_amt",
"pool_address",
"rpc_url",
"pool_type"
],
"properties": {
"rpc_url": {
"type": "string",
"description": "An Ethereum (or L2) JSON-RPC URL used to read live pool state. Required; supplied by you per call (BYO-RPC) and may carry your provider key. The endpoint stores and logs nothing — the URL is never persisted or written to logs."
},
"chain_id": {
"type": "integer",
"description": "Optional guard. If supplied and the RPC reports a different chain id, the call is rejected. Defaults to 1 (Ethereum mainnet) conceptually; omit to skip the check."
},
"lwr_tick": {
"type": [
"integer",
"null"
],
"description": "Lower tick of the position (V3 positions only; null for V2)."
},
"upr_tick": {
"type": [
"integer",
"null"
],
"description": "Upper tick of the position (V3 positions only; null for V2)."
},
"pool_type": {
"enum": [
"uniswap_v2",
"uniswap_v3"
],
"type": "string",
"description": "Which protocol the pool at pool_address belongs to. This tool accepts uniswap_v2 | uniswap_v3."
},
"entry_x_amt": {
"type": "number",
"description": "Amount of token0 originally deposited at position entry."
},
"entry_y_amt": {
"type": "number",
"description": "Amount of token1 originally deposited at position entry."
},
"lp_init_amt": {
"type": "number",
"description": "LP token amount held by the position (position size in human units)."
},
"block_number": {
"type": "integer",
"description": "Optional block number to pin the read to a historical block. Omit to read the latest block."
},
"pool_address": {
"type": "string",
"description": "On-chain address of the pool/pair to analyze (Uniswap V2/V3 pair, Balancer weighted pool, or Curve stableswap pool). Required. Lowercase, uppercase, or checksum casing all work."
},
"holding_period_days": {
"type": [
"number",
"null"
],
"description": "Optional holding period in days. If supplied, real_apr is annualized from net_pnl."
}
}
}| entry_amounts* | array | Per-token entry amounts in pool insertion order. Exactly 2 entries (2-asset pools only in v1). |
| holding_period_days | number | null | Optional holding period in days. If supplied, real_apr is annualized from net_pnl. |
{
"type": "object",
"required": [
"lp_init_amt",
"entry_amounts",
"pool_address",
"rpc_url",
"pool_type"
],
"properties": {
"rpc_url": {
"type": "string",
"description": "An Ethereum (or L2) JSON-RPC URL used to read live pool state. Required; supplied by you per call (BYO-RPC) and may carry your provider key. The endpoint stores and logs nothing — the URL is never persisted or written to logs."
},
"chain_id": {
"type": "integer",
"description": "Optional guard. If supplied and the RPC reports a different chain id, the call is rejected. Defaults to 1 (Ethereum mainnet) conceptually; omit to skip the check."
},
"pool_type": {
"enum": [
"stableswap"
],
"type": "string",
"description": "Which protocol the pool at pool_address belongs to. This tool accepts only stableswap (2-asset plain Curve pool)."
},
"lp_init_amt": {
"type": "number",
"description": "LP tokens held by this position, in human units."
},
"block_number": {
"type": "integer",
"description": "Optional block number to pin the read to a historical block. Omit to read the latest block."
},
"pool_address": {
"type": "string",
"description": "On-chain address of the pool/pair to analyze (Uniswap V2/V3 pair, Balancer weighted pool, or Curve stableswap pool). Required. Lowercase, uppercase, or checksum casing all work."
},
"entry_amounts": {
"type": "array",
"items": {
"type": "number"
},
"maxItems": 2,
"minItems": 2,
"description": "Per-token entry amounts in pool insertion order. Exactly 2 entries (2-asset pools only in v1)."
},
"holding_period_days": {
"type": [
"number",
"null"
],
"description": "Optional holding period in days. If supplied, real_apr is annualized from net_pnl."
}
}
}| depeg_levels | array | null | Depeg magnitudes as fractions in (0, 1). Default [0.02, 0.05, 0.10, 0.20, 0.50]. |
| pool_address* | string | On-chain address of the pool/pair to analyze (Uniswap V2/V3 pair, Balancer weighted pool, or Curve stableswap pool). Required. Lowercase, uppercase, or checksum casing all work. |
| depeg_token_name | string | Optional. Symbol of the asset assumed to depeg (e.g. 'USDC', 'DAI'). Must be one of the two tokens in the pool. If omitted, the pool's first token is used. |
{
"type": "object",
"required": [
"lp_init_amt",
"pool_address",
"rpc_url",
"pool_type"
],
"properties": {
"rpc_url": {
"type": "string",
"description": "An Ethereum (or L2) JSON-RPC URL used to read live pool state. Required; supplied by you per call (BYO-RPC) and may carry your provider key. The endpoint stores and logs nothing — the URL is never persisted or written to logs."
},
"chain_id": {
"type": "integer",
"description": "Optional guard. If supplied and the RPC reports a different chain id, the call is rejected. Defaults to 1 (Ethereum mainnet) conceptually; omit to skip the check."
},
"pool_type": {
"enum": [
"stableswap"
],
"type": "string",
"description": "Which protocol the pool at pool_address belongs to. This tool accepts only stableswap (2-asset plain Curve pool)."
},
"compare_v2": {
"type": [
"boolean",
"null"
],
"description": "If true (default), each scenario reports the equivalent V2 constant-product IL at the same price deviation."
},
"lp_init_amt": {
"type": "number",
"description": "LP tokens held, in human units. Must be > 0."
},
"block_number": {
"type": "integer",
"description": "Optional block number to pin the read to a historical block. Omit to read the latest block."
},
"depeg_levels": {
"type": [
"array",
"null"
],
"items": {
"type": "number"
},
"description": "Depeg magnitudes as fractions in (0, 1). Default [0.02, 0.05, 0.10, 0.20, 0.50]."
},
"pool_address": {
"type": "string",
"description": "On-chain address of the pool/pair to analyze (Uniswap V2/V3 pair, Balancer weighted pool, or Curve stableswap pool). Required. Lowercase, uppercase, or checksum casing all work."
},
"depeg_token_name": {
"type": "string",
"description": "Optional. Symbol of the asset assumed to depeg (e.g. 'USDC', 'DAI'). Must be one of the two tokens in the pool. If omitted, the pool's first token is used."
}
}
}| block_number |
| integer |
| Optional block number to pin the read to a historical block. Omit to read the latest block. |
| pool_address* | string | On-chain address of the pool/pair to snapshot. Required. Lowercase, uppercase, or checksum casing all work. |
{
"type": "object",
"required": [
"pool_address",
"rpc_url",
"pool_type"
],
"properties": {
"rpc_url": {
"type": "string",
"description": "An Ethereum (or L2) JSON-RPC URL used to read live pool state. Required; supplied by you per call (BYO-RPC) and may carry your provider key. The endpoint stores and logs nothing — the URL is never persisted or written to logs."
},
"chain_id": {
"type": "integer",
"description": "Optional guard. If supplied and the RPC reports a different chain id, the call is rejected. Omit to skip the check."
},
"lwr_tick": {
"type": "integer",
"description": "uniswap_v3 only — lower tick of the position range to snapshot. Omit for the pool's full active-liquidity range. Ignored for other pool types."
},
"upr_tick": {
"type": "integer",
"description": "uniswap_v3 only — upper tick of the position range to snapshot. Omit for the pool's full active-liquidity range. Ignored for other pool types."
},
"pool_type": {
"enum": [
"uniswap_v2",
"uniswap_v3",
"balancer",
"stableswap"
],
"type": "string",
"description": "Which protocol the pool at pool_address belongs to: 'uniswap_v2' | 'uniswap_v3' | 'balancer' (2-asset weighted) | 'stableswap' (2-asset plain Curve). All four are supported — this tool spans every snapshot type."
},
"block_number": {
"type": "integer",
"description": "Optional block number to pin the read to a historical block. Omit to read the latest block."
},
"pool_address": {
"type": "string",
"description": "On-chain address of the pool/pair to snapshot. Required. Lowercase, uppercase, or checksum casing all work."
}
}
}| Optional batch form of 'amount_in': an array of values to evaluate in a single call. The pool is read once and the result is an array with one entry per element, in input order. Supply EITHER 'amount_in' (single) OR 'amounts_in' (batch), not both. Max 256 entries. |
| block_number | integer | Optional block number to pin the read to a historical block. Omit to read the latest block. |
| pool_address* | string | On-chain address of the pool/pair to analyze (Uniswap V2/V3 pair, Balancer weighted pool, or Curve stableswap pool). Required. Lowercase, uppercase, or checksum casing all work. |
| token_in_name* | string | Symbol of the input token for the trade (e.g. 'USDC', 'WETH'). Must be one of the two tokens in the pool. |
{
"type": "object",
"required": [
"pool_address",
"rpc_url",
"pool_type",
"token_in_name"
],
"properties": {
"rpc_url": {
"type": "string",
"description": "An Ethereum (or L2) JSON-RPC URL used to read live pool state. Required; supplied by you per call (BYO-RPC) and may carry your provider key. The endpoint stores and logs nothing — the URL is never persisted or written to logs."
},
"chain_id": {
"type": "integer",
"description": "Optional guard. If supplied and the RPC reports a different chain id, the call is rejected. Defaults to 1 (Ethereum mainnet) conceptually; omit to skip the check."
},
"lwr_tick": {
"type": [
"integer",
"null"
],
"description": "Lower tick of the position (V3 only; null for V2)."
},
"upr_tick": {
"type": [
"integer",
"null"
],
"description": "Upper tick of the position (V3 only; null for V2)."
},
"amount_in": {
"type": "number",
"description": "Amount of token_in to trade, in human units. Must be > 0."
},
"pool_type": {
"enum": [
"uniswap_v2",
"uniswap_v3"
],
"type": "string",
"description": "Which protocol the pool at pool_address belongs to. This tool accepts uniswap_v2 | uniswap_v3."
},
"amounts_in": {
"type": "array",
"items": {
"type": "number"
},
"maxItems": 256,
"description": "Optional batch form of 'amount_in': an array of values to evaluate in a single call. The pool is read once and the result is an array with one entry per element, in input order. Supply EITHER 'amount_in' (single) OR 'amounts_in' (batch), not both. Max 256 entries."
},
"block_number": {
"type": "integer",
"description": "Optional block number to pin the read to a historical block. Omit to read the latest block."
},
"pool_address": {
"type": "string",
"description": "On-chain address of the pool/pair to analyze (Uniswap V2/V3 pair, Balancer weighted pool, or Curve stableswap pool). Required. Lowercase, uppercase, or checksum casing all work."
},
"token_in_name": {
"type": "string",
"description": "Symbol of the input token for the trade (e.g. 'USDC', 'WETH'). Must be one of the two tokens in the pool."
}
}
}| integer | null |
| Rolling window size for fee_accrual_rate_recent, in swap counts. Default 20. V2-only; ignored for V3. |
{
"type": "object",
"required": [
"pool_address",
"rpc_url",
"pool_type"
],
"properties": {
"rpc_url": {
"type": "string",
"description": "An Ethereum (or L2) JSON-RPC URL used to read live pool state. Required; supplied by you per call (BYO-RPC) and may carry your provider key. The endpoint stores and logs nothing — the URL is never persisted or written to logs."
},
"chain_id": {
"type": "integer",
"description": "Optional guard. If supplied and the RPC reports a different chain id, the call is rejected. Defaults to 1 (Ethereum mainnet) conceptually; omit to skip the check."
},
"pool_type": {
"enum": [
"uniswap_v2",
"uniswap_v3"
],
"type": "string",
"description": "Which protocol the pool at pool_address belongs to. This tool accepts uniswap_v2 | uniswap_v3."
},
"block_number": {
"type": "integer",
"description": "Optional block number to pin the read to a historical block. Omit to read the latest block."
},
"pool_address": {
"type": "string",
"description": "On-chain address of the pool/pair to analyze (Uniswap V2/V3 pair, Balancer weighted pool, or Curve stableswap pool). Required. Lowercase, uppercase, or checksum casing all work."
},
"recent_window": {
"type": [
"integer",
"null"
],
"description": "Rolling window size for fee_accrual_rate_recent, in swap counts. Default 20. V2-only; ignored for V3."
}
}
}| lp_concentration_threshold | number | null | Top-LP share (strict-greater-than) that triggers the concentration signal. In (0, 1]; default 0.90; pass 1.0 to disable. |
{
"type": "object",
"required": [
"pool_address",
"rpc_url",
"pool_type"
],
"properties": {
"rpc_url": {
"type": "string",
"description": "An Ethereum (or L2) JSON-RPC URL used to read live pool state. Required; supplied by you per call (BYO-RPC) and may carry your provider key. The endpoint stores and logs nothing — the URL is never persisted or written to logs."
},
"chain_id": {
"type": "integer",
"description": "Optional guard. If supplied and the RPC reports a different chain id, the call is rejected. Defaults to 1 (Ethereum mainnet) conceptually; omit to skip the check."
},
"pool_type": {
"enum": [
"uniswap_v2",
"uniswap_v3"
],
"type": "string",
"description": "Which protocol the pool at pool_address belongs to. This tool accepts uniswap_v2 | uniswap_v3."
},
"tvl_floor": {
"type": [
"number",
"null"
],
"description": "Minimum acceptable TVL in token0 numeraire. Values at or below fire the tvl_suspiciously_low signal. Default 10.0 is nominal; override for your pair."
},
"block_number": {
"type": "integer",
"description": "Optional block number to pin the read to a historical block. Omit to read the latest block."
},
"pool_address": {
"type": "string",
"description": "On-chain address of the pool/pair to analyze (Uniswap V2/V3 pair, Balancer weighted pool, or Curve stableswap pool). Required. Lowercase, uppercase, or checksum casing all work."
},
"lp_concentration_threshold": {
"type": [
"number",
"null"
],
"description": "Top-LP share (strict-greater-than) that triggers the concentration signal. In (0, 1]; default 0.90; pass 1.0 to disable."
}
}
}| price_change_pct | number | Fractional price change from current spot. Must be > -1.0. Example: -0.30 models a 30% drop in base-in-opp terms. |
| price_change_pcts | array | Optional batch form of 'price_change_pct': an array of values to evaluate in a single call. The pool is read once and the result is an array with one entry per element, in input order. Supply EITHER 'price_change_pct' (single) OR 'price_change_pcts' (batch), not both. Max 256 entries. |
{
"type": "object",
"required": [
"lp_init_amt",
"pool_address",
"rpc_url",
"pool_type"
],
"properties": {
"rpc_url": {
"type": "string",
"description": "An Ethereum (or L2) JSON-RPC URL used to read live pool state. Required; supplied by you per call (BYO-RPC) and may carry your provider key. The endpoint stores and logs nothing — the URL is never persisted or written to logs."
},
"chain_id": {
"type": "integer",
"description": "Optional guard. If supplied and the RPC reports a different chain id, the call is rejected. Defaults to 1 (Ethereum mainnet) conceptually; omit to skip the check."
},
"pool_type": {
"enum": [
"balancer"
],
"type": "string",
"description": "Which protocol the pool at pool_address belongs to. This tool accepts only balancer (2-asset weighted pool)."
},
"lp_init_amt": {
"type": "number",
"description": "Pool shares held by this position, in human units. Must be > 0."
},
"block_number": {
"type": "integer",
"description": "Optional block number to pin the read to a historical block. Omit to read the latest block."
},
"pool_address": {
"type": "string",
"description": "On-chain address of the pool/pair to analyze (Uniswap V2/V3 pair, Balancer weighted pool, or Curve stableswap pool). Required. Lowercase, uppercase, or checksum casing all work."
},
"price_change_pct": {
"type": "number",
"description": "Fractional price change from current spot. Must be > -1.0. Example: -0.30 models a 30% drop in base-in-opp terms."
},
"price_change_pcts": {
"type": "array",
"items": {
"type": "number"
},
"maxItems": 256,
"description": "Optional batch form of 'price_change_pct': an array of values to evaluate in a single call. The pool is read once and the result is an array with one entry per element, in input order. Supply EITHER 'price_change_pct' (single) OR 'price_change_pcts' (batch), not both. Max 256 entries."
}
}
}| string |
| On-chain address of the pool/pair to analyze (Uniswap V2/V3 pair, Balancer weighted pool, or Curve stableswap pool). Required. Lowercase, uppercase, or checksum casing all work. |
| position_size_lp* | number | LP tokens held by the position, in human units. Must be > 0. |
| price_change_pct | number | Fractional price change from current price. Must be > -1.0. Example: -0.30 models a 30% drop. |
| price_change_pcts | array | Optional batch form of 'price_change_pct': an array of values to evaluate in a single call. The pool is read once and the result is an array with one entry per element, in input order. Supply EITHER 'price_change_pct' (single) OR 'price_change_pcts' (batch), not both. Max 256 entries. |
{
"type": "object",
"required": [
"position_size_lp",
"pool_address",
"rpc_url",
"pool_type"
],
"properties": {
"rpc_url": {
"type": "string",
"description": "An Ethereum (or L2) JSON-RPC URL used to read live pool state. Required; supplied by you per call (BYO-RPC) and may carry your provider key. The endpoint stores and logs nothing — the URL is never persisted or written to logs."
},
"chain_id": {
"type": "integer",
"description": "Optional guard. If supplied and the RPC reports a different chain id, the call is rejected. Defaults to 1 (Ethereum mainnet) conceptually; omit to skip the check."
},
"lwr_tick": {
"type": [
"integer",
"null"
],
"description": "Lower tick of the position (V3 only; null for V2)."
},
"upr_tick": {
"type": [
"integer",
"null"
],
"description": "Upper tick of the position (V3 only; null for V2)."
},
"pool_type": {
"enum": [
"uniswap_v2",
"uniswap_v3"
],
"type": "string",
"description": "Which protocol the pool at pool_address belongs to. This tool accepts uniswap_v2 | uniswap_v3."
},
"block_number": {
"type": "integer",
"description": "Optional block number to pin the read to a historical block. Omit to read the latest block."
},
"pool_address": {
"type": "string",
"description": "On-chain address of the pool/pair to analyze (Uniswap V2/V3 pair, Balancer weighted pool, or Curve stableswap pool). Required. Lowercase, uppercase, or checksum casing all work."
},
"position_size_lp": {
"type": "number",
"description": "LP tokens held by the position, in human units. Must be > 0."
},
"price_change_pct": {
"type": "number",
"description": "Fractional price change from current price. Must be > -1.0. Example: -0.30 models a 30% drop."
},
"price_change_pcts": {
"type": "array",
"items": {
"type": "number"
},
"maxItems": 256,
"description": "Optional batch form of 'price_change_pct': an array of values to evaluate in a single call. The pool is read once and the result is an array with one entry per element, in input order. Supply EITHER 'price_change_pct' (single) OR 'price_change_pcts' (batch), not both. Max 256 entries."
}
}
}| price_change_pct | number | Fractional shock applied to current alpha. Must be > -1.0. Simulated alpha = current_alpha * (1 + price_change_pct). |
| price_change_pcts | array | Optional batch form of 'price_change_pct': an array of values to evaluate in a single call. The pool is read once and the result is an array with one entry per element, in input order. Supply EITHER 'price_change_pct' (single) OR 'price_change_pcts' (batch), not both. Max 256 entries. |
{
"type": "object",
"required": [
"lp_init_amt",
"pool_address",
"rpc_url",
"pool_type"
],
"properties": {
"rpc_url": {
"type": "string",
"description": "An Ethereum (or L2) JSON-RPC URL used to read live pool state. Required; supplied by you per call (BYO-RPC) and may carry your provider key. The endpoint stores and logs nothing — the URL is never persisted or written to logs."
},
"chain_id": {
"type": "integer",
"description": "Optional guard. If supplied and the RPC reports a different chain id, the call is rejected. Defaults to 1 (Ethereum mainnet) conceptually; omit to skip the check."
},
"pool_type": {
"enum": [
"stableswap"
],
"type": "string",
"description": "Which protocol the pool at pool_address belongs to. This tool accepts only stableswap (2-asset plain Curve pool)."
},
"lp_init_amt": {
"type": "number",
"description": "LP tokens held by this position, in human units. Must be > 0."
},
"block_number": {
"type": "integer",
"description": "Optional block number to pin the read to a historical block. Omit to read the latest block."
},
"pool_address": {
"type": "string",
"description": "On-chain address of the pool/pair to analyze (Uniswap V2/V3 pair, Balancer weighted pool, or Curve stableswap pool). Required. Lowercase, uppercase, or checksum casing all work."
},
"price_change_pct": {
"type": "number",
"description": "Fractional shock applied to current alpha. Must be > -1.0. Simulated alpha = current_alpha * (1 + price_change_pct)."
},
"price_change_pcts": {
"type": "array",
"items": {
"type": "number"
},
"maxItems": 256,
"description": "Optional batch form of 'price_change_pct': an array of values to evaluate in a single call. The pool is read once and the result is an array with one entry per element, in input order. Supply EITHER 'price_change_pct' (single) OR 'price_change_pcts' (batch), not both. Max 256 entries."
}
}
}