Arcadia Finance

Official35 toolsLive

by arcadia-finance · TypeScript

Concentrated liquidity on Uniswap/Aerodrome (rebalance, compound, leverage) or single-sided lending.

Arcadia Finance MCP Server

The io.github.arcadia-finance/mcp-server is an MCP server for Arcadia Finance focused on DeFi strategies: concentrated liquidity on Uniswap/Aerodrome (including rebalance, compound, and leverage) and single-sided lending. The repository describes functionality exposed via Model Context Protocol tools, with 35 tools available.

🛠️ Key Features

Concentrated liquidity for Uniswap and Aerodrome
Rebalance, compound, and leverage actions
Single-sided lending support
MCP tooling (toolCount: 35)

🚀 Use Cases

Managing concentrated liquidity positions
Rebalancing or compounding liquidity strategies
Applying leverage-related liquidity approaches
Interfacing with single-sided lending workflows

⚡ Developer Benefits

Standardized access through the Model Context Protocol (MCP)
Typed implementation indicated by TypeScript 5.5
Project categorized under DeFi and lending topics (arcadia, defi, lending, liquidity)

⚠️ Limitations

Scope described only for Uniswap/Aerodrome concentrated liquidity and single-sided lending
Tool inventory is limited to what the server provides (35 tools)

Topics

arcadiabasedefilendingliquiditymcpmcp-servermodel-context-protocoloptimismunichain

Captured live from the server via tools/list.

read_account_info

Get full overview of an Arcadia account: health factor, collateral value, debt, deposited assets, liquidation price, and automation status. Health factor = 1 - (used_margin / liquidation_value): 1 = no debt (safest), >0 = healthy, 0 = liquidation threshold, <0 = past liquidation. Higher is safer. The `automation` object reports which asset managers are enabled (rebalancer, compounder, yield_claimer, cow_swapper, merkl_operator, gas_relayer), each as the position's dex_protocol when protocol-specific or true when account-level, plus `inferred_intents` (the automations those managers add up to), `merkl` claim state, and `deprecated_managers` for any superseded deployment still set on the account. Superseded managers should be cleared: write_account_automations disables them as part of a save. For the full decoded per-manager config use read_asset_manager_current. LP positions in assets[] include a dex_protocol field (slipstream, slipstream_v2, slipstream_v3, staked_slipstream, staked_slipstream_v2, staked_slipstream_v3, uniV3, uniV4). To configure automations, prefer passing the position's id as position_id to write_account_automations, which resolves the protocol and tokens for you; the dex_protocol value is also accepted directly as its `protocol` param. Slipstream V2 is Base-only. V3 is available on Base and Optimism. Unichain supports only Slipstream V1, uniV3, and uniV4. Numeric fields without a _usd suffix are in the account's numeraire token raw units (divide by 10^decimals: 6 for USDC, 18 for WETH, 8 for cbBTC). Fields ending in _usd are in USD with 18 decimals (divide by 1e18). health_factor is unitless. Asset amounts are raw token units. To list all accounts for a wallet, use read_wallet_accounts.

Parameters2

account_address	string	required	Arcadia account address
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "account_address": {
      "type": "string",
      "description": "Arcadia account address"
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "required": [
    "account_address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

read_account_history

Get historical collateral and debt values for an Arcadia account over time. Returns a time series of snapshots (timestamp, collateral_value, debt_value, net_value). Each value is the account's net value in USD (human-readable, not raw units). Useful for charting account performance over a period.

Parameters3

account_address	string	required	Arcadia account address
days	number	optional	Number of days of history (default 14)
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "account_address": {
      "type": "string",
      "description": "Arcadia account address"
    },
    "days": {
      "type": "number",
      "default": 14,
      "description": "Number of days of history (default 14)"
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "required": [
    "account_address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

read_account_pnl

Get PnL (cost basis) and yield earned for an Arcadia account. Returns lifetime totals: cost basis vs current value (negative cost_basis = net profit withdrawn), net transfers per token, total yield earned in USD and per token. cost_basis, current_value, cost_diff are in USD (human-readable). Per-token fields (net_transfers, summed_yields_earned) are in raw token units.

Parameters2

account_address	string	required	Arcadia account address
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "account_address": {
      "type": "string",
      "description": "Arcadia account address"
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "required": [
    "account_address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

read_pool_list

List all Arcadia lending pools: TVL, utilization, available liquidity. Key fields: interest_rate = current borrow cost, lending_apy = lender yield. All rates are decimal fractions (1.0 = 100%, 0.06 = 6%). For APY history on a specific pool, use read_pool_info.

Parameters1

chain_id

number

optional

Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

read_pool_info

Get detailed info for a single lending pool including APY history over time. Useful for analyzing rate trends and comparing pools. Use read_pool_list to discover pool addresses.

Parameters3

pool_address	string	required	Pool address
days	number	optional	Number of days of APY history
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "pool_address": {
      "type": "string",
      "description": "Pool address"
    },
    "days": {
      "type": "number",
      "default": 14,
      "description": "Number of days of APY history"
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "required": [
    "pool_address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

read_asset_list

List supported collateral assets on Arcadia. Returns compact list (address, symbol, decimals, type). Use search to filter by symbol substring. For USD prices, use read_asset_prices.

Parameters2

search	string	optional	Filter assets by symbol (case-insensitive substring match)
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "search": {
      "type": "string",
      "description": "Filter assets by symbol (case-insensitive substring match)"
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

read_asset_prices

Get USD prices for one or more asset addresses. Pass a single address or comma-separated addresses. Returns a price map keyed by address.

Parameters2

asset_addresses	string	required	Single address or comma-separated addresses for price lookup
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "asset_addresses": {
      "type": "string",
      "description": "Single address or comma-separated addresses for price lookup"
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "required": [
    "asset_addresses"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

read_strategy_list

Get Arcadia LP strategies. Use featured_only=true for curated top strategies (recommended first call). Returns a paginated list with 7d avg APY for each strategy's default range. Increase limit or use offset for pagination. All APY values are decimal fractions (1.0 = 100%, 0.05 = 5%). For full detail on a specific strategy (APY per range width), use read_strategy_info.

Parameters4

featured_only	boolean	optional	Return only featured/curated strategies (recommended)
limit	number	optional	Max strategies to return (default 25)
offset	number	optional	Skip first N strategies for pagination
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "featured_only": {
      "type": "boolean",
      "default": false,
      "description": "Return only featured/curated strategies (recommended)"
    },
    "limit": {
      "type": "number",
      "default": 25,
      "description": "Max strategies to return (default 25)"
    },
    "offset": {
      "type": "number",
      "default": 0,
      "description": "Skip first N strategies for pagination"
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

read_strategy_info

Get full detail for a specific LP strategy by ID — includes APY per range width (narrower range = higher APY but more rebalancing cost/risk), pool info, and configuration. Use read_strategy_list to discover strategy IDs. All APY values are decimal fractions (1.0 = 100%, 0.05 = 5%).

Parameters2

strategy_id	number	required	Strategy ID
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "strategy_id": {
      "type": "number",
      "description": "Strategy ID"
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "required": [
    "strategy_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

read_strategy_recommendation

Get a rebalancing recommendation for an Arcadia account — suggests asset changes to optimize yield. Uses 1d APY (not 7d like read_strategy_list), so recommended strategies may differ from the list ranking. APY values are decimal fractions (0.05 = 5%). weekly_earning_difference is in USD.

Parameters2

account_address	string	required	Arcadia account address
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "account_address": {
      "type": "string",
      "description": "Arcadia account address"
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "required": [
    "account_address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

read_point_leaderboard

Get the Arcadia points leaderboard (paginated). For a specific wallet's points balance, use read_wallet_points.

Parameters2

limit	number	optional	Max leaderboard entries to return (default 25)
offset	number	optional	Skip first N leaderboard entries for pagination

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "default": 25,
      "description": "Max leaderboard entries to return (default 25)"
    },
    "offset": {
      "type": "number",
      "default": 0,
      "description": "Skip first N leaderboard entries for pagination"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

read_guides

Get Arcadia workflow guides and reference documentation. Call this before multi-step workflows (opening LP positions, enabling automation, closing positions) or when you need contract addresses, asset manager addresses, or strategy parameters. Topics: overview (addresses + tool catalog), automation (intent-based automation setup), strategies (step-by-step templates), selection (how to evaluate and parameterize strategies).

Parameters1

topic

string

optional

overview = addresses + tool catalog, automation = intent-based automation setup, strategies = step-by-step LP templates, selection = pool evaluation + leverage sizing

Raw schema

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "enum": [
        "overview",
        "automation",
        "strategies",
        "selection"
      ],
      "description": "overview = addresses + tool catalog, automation = intent-based automation setup, strategies = step-by-step LP templates, selection = pool evaluation + leverage sizing"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

read_wallet_balances

Get native ETH and ERC20 token balances for a wallet address. Reads directly from chain via RPC multicall. Use before write_account_add_liquidity or write_account_deposit to verify the wallet has sufficient tokens. Returns both raw balance (smallest unit/wei) and formatted (human-readable) per token.

Parameters3

wallet_address	string	required	Wallet address to check balances for
token_addresses	array	required	ERC20 token contract addresses to check
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "wallet_address": {
      "type": "string",
      "description": "Wallet address to check balances for"
    },
    "token_addresses": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "ERC20 token contract addresses to check"
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "required": [
    "wallet_address",
    "token_addresses"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

read_wallet_allowances

Check ERC20 token allowances for a spender address. Use before write_wallet_approve to avoid redundant approvals — skip approving if the current allowance is already sufficient.

Parameters4

owner_address	string	required	Token owner address (the wallet granting approval)
spender_address	string	required	Spender address to check allowance for (e.g. Arcadia account address)
token_addresses	array	required	ERC20 token contract addresses to check
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "owner_address": {
      "type": "string",
      "description": "Token owner address (the wallet granting approval)"
    },
    "spender_address": {
      "type": "string",
      "description": "Spender address to check allowance for (e.g. Arcadia account address)"
    },
    "token_addresses": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "ERC20 token contract addresses to check"
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "required": [
    "owner_address",
    "spender_address",
    "token_addresses"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

read_wallet_accounts

List all Arcadia accounts owned by a wallet address. Returns a summary of each account (address, name). Call read_account_info with a specific account_address for full details like health factor, collateral, and debt.

Parameters2

wallet_address	string	required	Wallet address to list accounts for
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "wallet_address": {
      "type": "string",
      "description": "Wallet address to list accounts for"
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "required": [
    "wallet_address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

read_wallet_points

Get Arcadia points balance for a specific wallet address.

Parameters1

wallet_address

string

required

Wallet address to get points for

Raw schema

{
  "type": "object",
  "properties": {
    "wallet_address": {
      "type": "string",
      "description": "Wallet address to get points for"
    }
  },
  "required": [
    "wallet_address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

read_asset_manager_intents

List the automation intents Arcadia supports, with the parameters each one accepts. Pass account_address to also get per-account availability: which intents can be enabled right now and, for any that cannot, the compatibility rule blocking it. Pass position_id as well to scope availability to one LP position. Without account_address this returns the catalog only.

Parameters3

account_address	string	optional	Arcadia account address. Include it to get live per-account availability.
position_id	integer	optional	LP position (NFT) id to scope availability to. Requires account_address.
chain_id	number	optional	Chain id: 8453 Base, 130 Unichain, 10 Optimism

Raw schema

{
  "type": "object",
  "properties": {
    "account_address": {
      "type": "string",
      "description": "Arcadia account address. Include it to get live per-account availability."
    },
    "position_id": {
      "type": "integer",
      "description": "LP position (NFT) id to scope availability to. Requires account_address."
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain id: 8453 Base, 130 Unichain, 10 Optimism"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

read_asset_manager_current

Read which asset managers are currently enabled on an account, with their decoded on-chain configuration. Returns the active managers (address, protocol, initiator, decoded strategy metadata, slippage and value-loss caps, fee recipient), the intents they map to, and Merkl claim state including whether reward tokens still need registering. Managers from superseded deployments are listed separately under `deprecated`: pass their addresses to write_account_automations_delta to clear them, or run write_account_automations which disables them as part of the save. read_ok is false when chain state could not be read, in which case the result is unreliable rather than empty.

Parameters2

account_address	string	required	Arcadia account address
chain_id	number	optional	Chain id: 8453 Base, 130 Unichain, 10 Optimism

Raw schema

{
  "type": "object",
  "properties": {
    "account_address": {
      "type": "string",
      "description": "Arcadia account address"
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain id: 8453 Base, 130 Unichain, 10 Optimism"
    }
  },
  "required": [
    "account_address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

write_account_create

Build an unsigned transaction to create a new Arcadia account via the Factory contract. account_version: 3 with creditor → V3 margin account (can borrow/leverage). account_version: 0 or 4 → V4 spot account (no borrowing, creditor is ignored, any ERC20 allowed). Returns the predicted account address (deterministic via CREATE2).

Parameters5

salt	number	required	Unique salt (uint32) for deterministic account address
wallet_address	string	required	Wallet address that will send the transaction (tx.origin, needed for address prediction)
account_version	number	optional	Account version: 0 = latest (V4 spot), 3 = margin (can borrow). 1/2 = legacy.
creditor	string	optional	Lending pool address for V3 margin account. Ignored for V4 spot accounts (version 0 or 4).
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "salt": {
      "type": "number",
      "description": "Unique salt (uint32) for deterministic account address"
    },
    "wallet_address": {
      "type": "string",
      "description": "Wallet address that will send the transaction (tx.origin, needed for address prediction)"
    },
    "account_version": {
      "type": "number",
      "default": 0,
      "description": "Account version: 0 = latest (V4 spot), 3 = margin (can borrow). 1/2 = legacy."
    },
    "creditor": {
      "type": "string",
      "description": "Lending pool address for V3 margin account. Ignored for V4 spot accounts (version 0 or 4)."
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "required": [
    "salt",
    "wallet_address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

write_account_deposit

Build an unsigned transaction to deposit assets into an Arcadia account as collateral. Supports ERC20 tokens and ERC721 NFTs (LP positions). NOT needed before write_account_add_liquidity — that tool deposits from wallet atomically. Ensure the account is approved first (call read_wallet_allowances to check, then write_wallet_approve if needed). Account version is auto-detected on-chain (override with account_version if needed).

Parameters7

account_address	string	required	Arcadia account address
asset_addresses	array	required	Token contract addresses to deposit
asset_amounts	array	required	Amounts in raw units/wei, one per asset
asset_ids	array	optional	Token IDs: 0 for ERC20, NFT token ID for ERC721
asset_types	array	optional	V4 only. Asset types per asset: 1=ERC20, 2=ERC721, 3=ERC1155. If omitted, inferred from asset_ids (non-zero → ERC721).
account_version	number	optional	Override account version (3 or 4). Auto-detected on-chain if omitted.
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "account_address": {
      "type": "string",
      "description": "Arcadia account address"
    },
    "asset_addresses": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Token contract addresses to deposit"
    },
    "asset_amounts": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Amounts in raw units/wei, one per asset"
    },
    "asset_ids": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Token IDs: 0 for ERC20, NFT token ID for ERC721"
    },
    "asset_types": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "V4 only. Asset types per asset: 1=ERC20, 2=ERC721, 3=ERC1155. If omitted, inferred from asset_ids (non-zero → ERC721)."
    },
    "account_version": {
      "type": "number",
      "description": "Override account version (3 or 4). Auto-detected on-chain if omitted."
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "required": [
    "account_address",
    "asset_addresses",
    "asset_amounts"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

write_account_withdraw

Build an unsigned transaction to withdraw assets from an Arcadia account to the owner's wallet. Only the account owner can withdraw. Will revert if the account has debt and withdrawal would make it undercollateralized. Does not support max_uint256 — pass exact amounts from read_account_info. Account version is auto-detected on-chain (override with account_version if needed).

Parameters7

account_address	string	required	Arcadia account address
asset_addresses	array	required	Token contract addresses to withdraw
asset_amounts	array	required	Amounts in raw units/wei, one per asset
asset_ids	array	optional	Token IDs: 0 for ERC20, NFT token ID for ERC721
asset_types	array	optional	V4 only. Asset types per asset: 1=ERC20, 2=ERC721, 3=ERC1155. If omitted, inferred from asset_ids (non-zero → ERC721).
account_version	number	optional	Override account version (3 or 4). Auto-detected on-chain if omitted.
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "account_address": {
      "type": "string",
      "description": "Arcadia account address"
    },
    "asset_addresses": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Token contract addresses to withdraw"
    },
    "asset_amounts": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Amounts in raw units/wei, one per asset"
    },
    "asset_ids": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Token IDs: 0 for ERC20, NFT token ID for ERC721"
    },
    "asset_types": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "V4 only. Asset types per asset: 1=ERC20, 2=ERC721, 3=ERC1155. If omitted, inferred from asset_ids (non-zero → ERC721)."
    },
    "account_version": {
      "type": "number",
      "description": "Override account version (3 or 4). Auto-detected on-chain if omitted."
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "required": [
    "account_address",
    "asset_addresses",
    "asset_amounts"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

write_account_borrow

Build an unsigned transaction to borrow from an Arcadia lending pool against account collateral. NOT needed for leveraged LP — write_account_add_liquidity handles borrowing internally when leverage > 0. Only works with margin accounts (created with a creditor/lending pool). Spot accounts (no creditor) cannot borrow — the tool will validate this and reject. Before borrowing, verify the account has positive free margin via read_account_info: collateral_value must exceed used_margin.

Parameters5

pool_address	string	required	Lending pool: LP_WETH=0x803ea69c7e87D1d6C86adeB40CB636cC0E6B98E2, LP_USDC=0x3ec4a293Fb906DD2Cd440c20dECB250DeF141dF1, LP_CBBTC=0xa37E9b4369dc20940009030BfbC2088F09645e3B
account_address	string	required	Arcadia account address used as collateral
amount	string	required	Amount in raw units
to	string	required	Address to receive borrowed tokens
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "pool_address": {
      "type": "string",
      "description": "Lending pool: LP_WETH=0x803ea69c7e87D1d6C86adeB40CB636cC0E6B98E2, LP_USDC=0x3ec4a293Fb906DD2Cd440c20dECB250DeF141dF1, LP_CBBTC=0xa37E9b4369dc20940009030BfbC2088F09645e3B"
    },
    "account_address": {
      "type": "string",
      "description": "Arcadia account address used as collateral"
    },
    "amount": {
      "type": "string",
      "description": "Amount in raw units"
    },
    "to": {
      "type": "string",
      "description": "Address to receive borrowed tokens"
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "required": [
    "pool_address",
    "account_address",
    "amount",
    "to"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

write_account_repay

Repay debt to an Arcadia lending pool using tokens from the wallet (requires ERC20 allowance). To repay using account collateral instead (no wallet tokens needed), use write_account_deleverage. Check allowance first (read_wallet_allowances), then approve the pool if needed (write_wallet_approve). Check outstanding debt with read_account_info.

Parameters4

pool_address	string	required	Lending pool address. Base: LP_WETH=0x803ea69c7e87D1d6C86adeB40CB636cC0E6B98E2, LP_USDC=0x3ec4a293Fb906DD2Cd440c20dECB250DeF141dF1, LP_CBBTC=0xa37E9b4369dc20940009030BfbC2088F09645e3B
account_address	string	required	Arcadia account address with debt
amount	string	required	Amount in raw units, or 'max_uint256' to repay all debt in full
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "pool_address": {
      "type": "string",
      "description": "Lending pool address. Base: LP_WETH=0x803ea69c7e87D1d6C86adeB40CB636cC0E6B98E2, LP_USDC=0x3ec4a293Fb906DD2Cd440c20dECB250DeF141dF1, LP_CBBTC=0xa37E9b4369dc20940009030BfbC2088F09645e3B"
    },
    "account_address": {
      "type": "string",
      "description": "Arcadia account address with debt"
    },
    "amount": {
      "type": "string",
      "description": "Amount in raw units, or 'max_uint256' to repay all debt in full"
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "required": [
    "pool_address",
    "account_address",
    "amount"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

write_account_add_liquidity

Multi-step flash-action: atomically combines [deposit from wallet] + [use account collateral] + [swap to optimal ratio] + [mint LP] + [borrow if leveraged] in ONE transaction. Do NOT call write_account_deposit separately. Capital sources: wallet tokens (deposits array), existing account collateral (use_account_assets=true), or both. Check allowances first (read_wallet_allowances), then approve if needed (write_wallet_approve). Supports depositing multiple tokens and minting multiple LP positions in one tx. Works with both margin accounts (can leverage) and spot accounts (no leverage). For workflows, call read_guides('strategies'). The returned calldata is time-sensitive — sign and broadcast within 30 seconds. If the transaction reverts due to price movement, rebuild and sign again immediately (retry at least once before giving up). Response includes tenderly_sim_url and tenderly_sim_status for pre-broadcast validation. expected_value_change is in raw units of the account's numeraire token (6 decimals for USDC, 18 for WETH). Negative = cost to open, positive = value gained. Compare before.total_account_value and after.total_account_value for the full picture.

Parameters8

account_address	string	required	Arcadia account address
wallet_address	string	required	Wallet address of the account owner
positions	array	required	LP positions to mint. For a single position, pass one entry.
deposits	array	optional	Wallet tokens to deposit. Approve each token first (write.wallet.approve). Omit to use only account collateral.
use_account_assets	boolean	optional	If true, use ALL existing account collateral for LP minting. Fetched automatically.
leverage	number	optional	0 = no borrow, 2 = 2x leverage. Margin accounts only.
slippage	number	optional	Basis points, 100 = 1%
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "account_address": {
      "type": "string",
      "description": "Arcadia account address"
    },
    "wallet_address": {
      "type": "string",
      "description": "Wallet address of the account owner"
    },
    "positions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "strategy_id": {
            "type": "number",
            "description": "From read.strategy.list (or read.strategy.info for full range detail)"
          },
          "tick_lower": {
            "type": "number",
            "description": "Lower tick for concentrated range. Omit for full range."
          },
          "tick_upper": {
            "type": "number",
            "description": "Upper tick for concentrated range. Omit for full range."
          }
        },
        "required": [
          "strategy_id"
        ],
        "additionalProperties": false
      },
      "description": "LP positions to mint. For a single position, pass one entry."
    },
    "deposits": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "asset": {
            "type": "string",
            "description": "Token address to deposit from wallet"
          },
          "amount": {
            "type": "string",
            "description": "Amount in raw units"
          },
          "decimals": {
            "type": "number",
            "description": "Token decimals (e.g. 6 for USDC, 18 for WETH). Default 18."
          }
        },
        "required": [
          "asset",
          "amount"
        ],
        "additionalProperties": false
      },
      "description": "Wallet tokens to deposit. Approve each token first (write.wallet.approve). Omit to use only account collateral."
    },
    "use_account_assets": {
      "type": "boolean",
      "default": false,
      "description": "If true, use ALL existing account collateral for LP minting. Fetched automatically."
    },
    "leverage": {
      "type": "number",
      "default": 0,
      "description": "0 = no borrow, 2 = 2x leverage. Margin accounts only."
    },
    "slippage": {
      "type": "number",
      "default": 100,
      "description": "Basis points, 100 = 1%"
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "required": [
    "account_address",
    "wallet_address",
    "positions"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

write_account_remove_liquidity

Flash-action: PARTIALLY decreases liquidity from an LP position. The position remains open with reduced liquidity; underlying tokens stay in the account. For FULL position exit (burn LP + swap + repay + withdraw), use write_account_close instead — it batches everything into one atomic transaction. The returned calldata is time-sensitive — sign and broadcast within 30 seconds. If the transaction reverts due to price movement, rebuild and sign again immediately (retry at least once before giving up). Response includes tenderly_sim_url and tenderly_sim_status for pre-broadcast validation.

Parameters5

account_address	string	required	Arcadia account address
asset_address	string	required	Position manager contract
asset_id	number	required	NFT token ID
adjustment	string	required	Liquidity amount to remove (raw uint128 value as string). Must be less than total liquidity — for full removal use write.account.close.
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "account_address": {
      "type": "string",
      "description": "Arcadia account address"
    },
    "asset_address": {
      "type": "string",
      "description": "Position manager contract"
    },
    "asset_id": {
      "type": "number",
      "description": "NFT token ID"
    },
    "adjustment": {
      "type": "string",
      "description": "Liquidity amount to remove (raw uint128 value as string). Must be less than total liquidity — for full removal use write.account.close."
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "required": [
    "account_address",
    "asset_address",
    "asset_id",
    "adjustment"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

write_account_swap

Flash-action: swaps assets within an Arcadia account in one atomic transaction. The backend finds the optimal swap route. NOTE: If you are closing a position (swap + repay + withdraw), prefer write_account_close which batches everything atomically. Only use this tool for standalone swaps within an active position. The returned calldata is time-sensitive — sign and broadcast within 30 seconds. If the transaction reverts due to price movement, rebuild and sign again immediately (retry at least once before giving up). Response includes tenderly_sim_url and tenderly_sim_status for pre-broadcast validation — if tenderly_sim_status is 'false', do NOT broadcast the transaction.

Parameters6

account_address	string	required	Arcadia account address
asset_from	string	required	Token address to swap from
asset_to	string	required	Token address to swap to
amount_in	string	required	Raw units
slippage	number	optional	Basis points, 100 = 1%
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "account_address": {
      "type": "string",
      "description": "Arcadia account address"
    },
    "asset_from": {
      "type": "string",
      "description": "Token address to swap from"
    },
    "asset_to": {
      "type": "string",
      "description": "Token address to swap to"
    },
    "amount_in": {
      "type": "string",
      "description": "Raw units"
    },
    "slippage": {
      "type": "number",
      "default": 100,
      "description": "Basis points, 100 = 1%"
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "required": [
    "account_address",
    "asset_from",
    "asset_to",
    "amount_in"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

write_account_deleverage

Multi-step flash-action: sells account collateral to the debt token and repays in one atomic transaction — no wallet tokens needed. To repay from wallet tokens instead, use write_account_repay. NOTE: If you are closing a position (remove LP + swap + repay + withdraw), prefer write_account_close which batches everything atomically. Only use this tool for standalone repayment while keeping the position active. The returned calldata is time-sensitive — sign and broadcast within 30 seconds. If the transaction reverts due to price movement, rebuild and sign again immediately (retry at least once before giving up). Response includes tenderly_sim_url and tenderly_sim_status for pre-broadcast validation — if tenderly_sim_status is 'false', do NOT broadcast the transaction.

Parameters7

account_address	string	required	Arcadia account address
amount_in	string	required	Collateral amount to sell (raw units)
asset_from	string	required	Collateral token to sell
numeraire	string	required	Debt token address
creditor	string	required	Lending pool address
slippage	number	optional	Basis points, 100 = 1%
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "account_address": {
      "type": "string",
      "description": "Arcadia account address"
    },
    "amount_in": {
      "type": "string",
      "description": "Collateral amount to sell (raw units)"
    },
    "asset_from": {
      "type": "string",
      "description": "Collateral token to sell"
    },
    "numeraire": {
      "type": "string",
      "description": "Debt token address"
    },
    "creditor": {
      "type": "string",
      "description": "Lending pool address"
    },
    "slippage": {
      "type": "number",
      "default": 100,
      "description": "Basis points, 100 = 1%"
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "required": [
    "account_address",
    "amount_in",
    "asset_from",
    "numeraire",
    "creditor"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

write_account_stake

Flash-action: stake, unstake, or claim rewards for an LP position in one atomic transaction. Use the `action` parameter to select the operation. `asset_address` is the position manager contract — pass the non-staked PM address when staking, or the staked PM address when unstaking. The returned calldata is time-sensitive — sign and broadcast within 30 seconds. If the transaction reverts due to price movement, rebuild and sign again immediately (retry at least once before giving up). Tenderly simulation may not be available for this endpoint — verify the position exists with read_account_info before signing.

Parameters5

account_address	string	required	Arcadia account address
action	string	required	Action to perform
asset_address	string	required	Position manager contract address
asset_id	number	required	NFT token ID of the LP position
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "account_address": {
      "type": "string",
      "description": "Arcadia account address"
    },
    "action": {
      "type": "string",
      "enum": [
        "stake",
        "unstake",
        "claim"
      ],
      "description": "Action to perform"
    },
    "asset_address": {
      "type": "string",
      "description": "Position manager contract address"
    },
    "asset_id": {
      "type": "number",
      "description": "NFT token ID of the LP position"
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "required": [
    "account_address",
    "action",
    "asset_address",
    "asset_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

write_account_close

Atomic flash-action that closes an Arcadia account position in ONE transaction. Combines up to 3 steps atomically: [burn LP position] + [swap all tokens to a single target asset] + [repay debt]. Tokens remain in the account after closing — use write_account_withdraw to send them to your wallet. ALWAYS try this tool first when closing/exiting a position. Only fall back to individual tools (write_account_remove_liquidity, write_account_swap, write_account_deleverage, write_account_withdraw) if this tool fails. Supports two modes: - close_lp_only=true: Burns LP and leaves underlying tokens in the account. Use as step 1 if the full close fails, then call again with close_lp_only=false to swap+repay the remaining tokens. - close_lp_only=false (default): Full atomic close — burns LP, swaps everything to receive_assets, repays debt. Remaining tokens stay in the account. Follow up with write_account_withdraw to send to wallet. Supports multiple receive assets with custom distribution. The returned calldata is time-sensitive — sign and broadcast within 30 seconds. If the transaction reverts due to price movement, rebuild and sign again immediately (retry at least once before giving up). Response includes tenderly_sim_url and tenderly_sim_status for pre-broadcast validation.

Parameters6

account_address	string	required	Arcadia account address
assets	array	required	Assets to close/sell from the account. IMPORTANT: For LP positions (NFTs), always use amount='1' and decimals=1 — do NOT pass the liquidity amount. asset_address = position manager, asset_id = NFT token ID. For ERC20 tokens: asset_id = 0, amount = full balance in raw units, decimals = real token decimals. Get all values from read.account.info.
receive_assets	array	optional	Target assets to receive after closing. For a single target, pass one entry. Required when close_lp_only=false. Omit for close_lp_only=true.
close_lp_only	boolean	optional	true = only burn LP positions, leave underlying tokens in account. false = full close (burn + swap + repay).
slippage	number	optional	Basis points, 100 = 1%
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "account_address": {
      "type": "string",
      "description": "Arcadia account address"
    },
    "assets": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "asset_address": {
            "type": "string",
            "description": "Token or position manager address"
          },
          "asset_id": {
            "type": "number",
            "description": "NFT token ID (0 for ERC20 tokens)"
          },
          "amount": {
            "type": "string",
            "description": "Amount to sell (use '1' for NFT positions)"
          },
          "decimals": {
            "type": "number",
            "description": "Token decimals (use 1 for NFT positions)"
          }
        },
        "required": [
          "asset_address",
          "asset_id",
          "amount",
          "decimals"
        ],
        "additionalProperties": false
      },
      "description": "Assets to close/sell from the account. IMPORTANT: For LP positions (NFTs), always use amount='1' and decimals=1 — do NOT pass the liquidity amount. asset_address = position manager, asset_id = NFT token ID. For ERC20 tokens: asset_id = 0, amount = full balance in raw units, decimals = real token decimals. Get all values from read.account.info."
    },
    "receive_assets": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "asset_address": {
            "type": "string",
            "description": "Target token address (e.g. USDC, WETH)"
          },
          "decimals": {
            "type": "number",
            "description": "Token decimals of the target asset"
          },
          "distribution": {
            "type": "number",
            "description": "Fraction of proceeds (0-1). Defaults to equal split across all receive assets."
          }
        },
        "required": [
          "asset_address",
          "decimals"
        ],
        "additionalProperties": false
      },
      "description": "Target assets to receive after closing. For a single target, pass one entry. Required when close_lp_only=false. Omit for close_lp_only=true."
    },
    "close_lp_only": {
      "type": "boolean",
      "default": false,
      "description": "true = only burn LP positions, leave underlying tokens in account. false = full close (burn + swap + repay)."
    },
    "slippage": {
      "type": "number",
      "default": 100,
      "description": "Basis points, 100 = 1%"
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "required": [
    "account_address",
    "assets"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

write_wallet_approve

Build an unsigned approval transaction. For ERC20 tokens: generates approve(spender, amount). For ERC721/ERC1155 NFTs (e.g. LP positions): generates setApprovalForAll(operator, true). Required before write_account_deposit or write_account_add_liquidity (when depositing from wallet). Tip: call read_wallet_allowances first to check if approval already exists — skip this if the current allowance is sufficient.

Parameters5

token_address	string	required	Token contract address to approve
spender_address	string	required	Address being approved — use the Arcadia account address for deposits
asset_type	string	optional	Token type: 'erc20' (default) for fungible tokens, 'erc721' or 'erc1155' for NFTs (LP positions)
amount	string	optional	ERC20 only: amount in raw units, or 'max_uint256' for unlimited. Ignored for NFTs.
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "token_address": {
      "type": "string",
      "description": "Token contract address to approve"
    },
    "spender_address": {
      "type": "string",
      "description": "Address being approved — use the Arcadia account address for deposits"
    },
    "asset_type": {
      "type": "string",
      "enum": [
        "erc20",
        "erc721",
        "erc1155"
      ],
      "default": "erc20",
      "description": "Token type: 'erc20' (default) for fungible tokens, 'erc721' or 'erc1155' for NFTs (LP positions)"
    },
    "amount": {
      "type": "string",
      "default": "max_uint256",
      "description": "ERC20 only: amount in raw units, or 'max_uint256' for unlimited. Ignored for NFTs."
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "required": [
    "token_address",
    "spender_address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

write_pool_deposit

Build an unsigned deposit transaction into an Arcadia lending tranche (ERC-4626). Lenders deposit the pool's underlying asset (USDC/WETH/cbBTC) and receive tranche shares that accrue interest from borrowers. Requires prior ERC-20 approval to the tranche (see write_wallet_approve). To check current lender yield, call read_pool_list or read_pool_info.

Parameters4

tranche_address	string	required	Tranche contract address (ERC-4626 vault). Get this from read.pool.list — each pool's `tranches[0].address`.
assets	string	required	Amount of underlying asset to deposit, in raw units (e.g. '1000000' = 1 USDC since USDC has 6 decimals).
receiver	string	required	Address that receives the minted tranche shares. Usually the depositor's own wallet.
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "tranche_address": {
      "type": "string",
      "description": "Tranche contract address (ERC-4626 vault). Get this from read.pool.list — each pool's `tranches[0].address`."
    },
    "assets": {
      "type": "string",
      "description": "Amount of underlying asset to deposit, in raw units (e.g. '1000000' = 1 USDC since USDC has 6 decimals)."
    },
    "receiver": {
      "type": "string",
      "description": "Address that receives the minted tranche shares. Usually the depositor's own wallet."
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "required": [
    "tranche_address",
    "assets",
    "receiver"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

write_pool_redeem

Build an unsigned redeem transaction to withdraw from an Arcadia lending tranche (ERC-4626). Burns tranche shares and returns the corresponding amount of underlying asset, including accrued interest. The owner must be the shares holder; receiver is where the underlying asset is sent.

Parameters5

tranche_address	string	required	Tranche contract address (ERC-4626 vault). Get this from read.pool.list — each pool's `tranches[0].address`.
shares	string	required	Amount of tranche shares to burn, in raw units. To redeem everything, use the owner's full share balance.
receiver	string	required	Address that receives the underlying asset. Usually the owner's own wallet.
owner	string	required	Address that owns the tranche shares being burned. Normally the signer's own wallet.
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "tranche_address": {
      "type": "string",
      "description": "Tranche contract address (ERC-4626 vault). Get this from read.pool.list — each pool's `tranches[0].address`."
    },
    "shares": {
      "type": "string",
      "description": "Amount of tranche shares to burn, in raw units. To redeem everything, use the owner's full share balance."
    },
    "receiver": {
      "type": "string",
      "description": "Address that receives the underlying asset. Usually the owner's own wallet."
    },
    "owner": {
      "type": "string",
      "description": "Address that owns the tranche shares being burned. Normally the signer's own wallet."
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "required": [
    "tranche_address",
    "shares",
    "receiver",
    "owner"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

write_account_automations

Configure an account's automations from a list of intents and return the unsigned setAssetManagers transaction. The backend resolves which asset managers each intent needs, validates that the combination is compatible, encodes the metadata and builds the calldata, so you describe the desired outcome rather than the contracts. With mode 'save' (the default) the intents array is the complete desired state: the backend diffs it against what is currently enabled, so any automation you leave out is DISABLED by the returned transaction. Pass a single intent with enabled: false to turn everything off. Mode 'preview' validates and resolves the intents WITHOUT reading chain state and returns no transaction, because its calldata carries no disable entries and would only partially apply the state. Use it to check a combination is legal or to show a plan; use 'save' to get something signable. To toggle one automation without restating the rest, use write_account_automations_delta. Intents: - compound_fees: reinvest earned fees/rewards back into the LP. Optional 'tokens' scopes it per yielding token. A staked reward that is not a pool token is swapped in via CowSwap automatically. - claim_rewards: claim yield out. config.mode as_earned pays the tokens as-is, convert_to swaps them to config.buy_token via CowSwap. config.convert_tokens converts only a subset and claims the rest as-earned. config.destination account or wallet. - add_to_lp: fold idle pool-token balances (deposits, rebalance leftovers) back into the LP. Opt-in per token. - claim_merkl: auto-claim Merkl incentive rewards. Independent of the compounder/claimer/cowswapper triad and needs no position context. - rebalance: reposition the LP. strategy out_of_range (default), take_profit (runs on the dedicated profit-taker contract), or protocol_owned_liquidity. Pass position_id (from assets[] in read_account_info) and the backend fills in protocol, is_staked, token0, token1 and reward_tokens for you; anything you pass explicitly wins. claim_merkl needs no position context. Rules the backend enforces (a violation is returned as an error, never written on-chain): - Every yielding token must be assigned to exactly one of compound_fees or claim_rewards. Scoping one to a subset without covering the rest is rejected, and no token may be in both. - A wallet or custom-recipient payout requires a pure as-earned claim: nothing converted, and every yielding token claimed. Converts settle in the account. - convert_tokens must be a subset of the claimed tokens, and buy_token cannot be a compounded token, a converted token, or an add_to_lp folded token. - Each intent kind may appear only once, and a token list must not be empty or name a token the position does not yield. Returns { valid, errors, warnings, human_summary, plan, diff, transaction }. When a compatibility rule fires the call returns an error and no transaction: read errors[].reason, adjust the intents and retry. There is deliberately no transaction when the account already matches the request (no_changes_needed), when the Tenderly simulation predicts a revert (an error), or in preview mode (preview_only). Call read_asset_manager_intents first to see which intents this account can enable.

Parameters11

account_address	string	required	Arcadia account address
intents	array	required	Complete desired automation state. In save mode anything omitted is disabled, so include every automation to keep. A single intent with enabled: false disables all automations.
mode	string	optional	save diffs against on-chain state and returns a signable transaction that also disables anything omitted. preview resolves and validates only, returning a plan and no transaction.
position_id	integer	optional	LP position (NFT) id, as listed in assets[] by read.account.info. Supply this and the backend fetches protocol, staked flag, tokens and reward tokens for you. Strongly preferred over passing the position fields by hand.
protocol	string	optional	Position's DEX protocol. Only needed when position_id is omitted. Accepts the dex_protocol values the read tools return (slipstream, staked_slipstream_v3, uniV3, ...), which imply is_staked, as well as the canonical slipstream_v1 / uniswap_v3 spellings.
is_staked	boolean	optional	Whether the LP position is staked. Implied by a staked_* protocol value.
token0	string	optional	Pool token0 address.
token1	string	optional	Pool token1 address.
reward_tokens	array	optional	Staking reward token addresses.
owner	string	optional	Account owner EOA. Used to resolve wallet payout targets.
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "account_address": {
      "type": "string",
      "description": "Arcadia account address"
    },
    "intents": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "compound_fees"
              },
              "enabled": {
                "type": "boolean",
                "default": true,
                "description": "False disables this intent's managers instead of enabling them."
              },
              "position_id": {
                "type": "integer",
                "description": "LP position (NFT) id this intent applies to. Also used to auto-fetch position context."
              },
              "tokens": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "token0",
                    "token1",
                    "reward"
                  ]
                },
                "description": "Which tokens' yield to reinvest. Omit for all yielding tokens. 'reward' only exists on a staked position whose reward token is not a pool token. Every yielding token must be assigned to either compound_fees or claim_rewards, so if you scope this to a subset you must add a claim_rewards intent covering the rest."
              }
            },
            "required": [
              "kind"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "claim_rewards"
              },
              "enabled": {
                "$ref": "#/properties/intents/items/anyOf/0/properties/enabled"
              },
              "position_id": {
                "$ref": "#/properties/intents/items/anyOf/0/properties/position_id"
              },
              "config": {
                "type": "object",
                "properties": {
                  "mode": {
                    "type": "string",
                    "enum": [
                      "as_earned",
                      "convert_to"
                    ],
                    "default": "as_earned",
                    "description": "as_earned pays out the claimed tokens as-is; convert_to swaps them to buy_token via CowSwap. Use convert_tokens to convert only some of them."
                  },
                  "destination": {
                    "type": "string",
                    "enum": [
                      "account",
                      "wallet"
                    ],
                    "default": "account",
                    "description": "Payout target ('wallet' is the owner EOA). A wallet payout is only allowed for a pure as-earned claim: nothing converted, and every yielding token claimed. Any convert, or a claim scoped to a subset of tokens, must use 'account' because CowSwap settles there."
                  },
                  "buy_token": {
                    "type": "string",
                    "description": "ERC20 to swap into. Required whenever any token is being converted. It cannot be a token you also compound, one of the tokens being converted, or a token folded by add_to_lp."
                  },
                  "recipient": {
                    "type": "string",
                    "description": "Explicit payout address. Overrides destination when set, and is subject to the same pure-as-earned rule as a wallet payout unless it equals the account address."
                  },
                  "tokens": {
                    "type": "array",
                    "items": {
                      "$ref": "#/properties/intents/items/anyOf/0/properties/tokens/items"
                    },
                    "description": "Which tokens' yield to claim out. Omit for all yielding tokens. A token cannot be both claimed and compounded, and every yielding token must be assigned to one of the two."
                  },
                  "convert_tokens": {
                    "type": "array",
                    "items": {
                      "$ref": "#/properties/intents/items/anyOf/0/properties/tokens/items"
                    },
                    "description": "Subset of this intent's claimed tokens to swap to buy_token; the rest are claimed as-earned. Must be a subset of `tokens`. Omit to defer to mode (convert_to converts all claimed tokens, as_earned converts none). Use this for a partial convert, e.g. tokens: ['token0','reward'] with convert_tokens: ['reward'] swaps only the reward and claims token0 as-is."
                  }
                },
                "additionalProperties": false,
                "default": {}
              }
            },
            "required": [
              "kind"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "add_to_lp"
              },
              "enabled": {
                "$ref": "#/properties/intents/items/anyOf/0/properties/enabled"
              },
              "position_id": {
                "$ref": "#/properties/intents/items/anyOf/0/properties/position_id"
              },
              "tokens": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "token0",
                    "token1"
                  ]
                },
                "description": "Which pool tokens' idle account balance to fold into the LP. Omit for both. Folding is opt-in per token, and a folded token cannot be the buy_token of a claim_rewards convert."
              }
            },
            "required": [
              "kind"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "claim_merkl"
              },
              "enabled": {
                "$ref": "#/properties/intents/items/anyOf/0/properties/enabled"
              },
              "position_id": {
                "$ref": "#/properties/intents/items/anyOf/0/properties/position_id"
              },
              "config": {
                "type": "object",
                "properties": {
                  "destination": {
                    "type": "string",
                    "enum": [
                      "account",
                      "wallet"
                    ],
                    "default": "account"
                  },
                  "reward_recipient": {
                    "type": "string",
                    "description": "Explicit recipient address. Overrides destination when set."
                  }
                },
                "additionalProperties": false,
                "default": {}
              }
            },
            "required": [
              "kind"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "rebalance"
              },
              "enabled": {
                "$ref": "#/properties/intents/items/anyOf/0/properties/enabled"
              },
              "position_id": {
                "$ref": "#/properties/intents/items/anyOf/0/properties/position_id"
              },
              "strategy": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "const": "out_of_range"
                      },
                      "optimal_token0_ratio": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 1000000,
                        "default": 500000,
                        "description": "Target token0 composition after a rebalance, 1e6-scaled: 500000 = 50% (balanced, the default), 750000 = 75% token0, 0 = all token1."
                      },
                      "trigger_lower_tick_ratio": {
                        "type": "integer",
                        "default": 0,
                        "description": "Offset from tick_lower as a fraction of the position's tick range, 1e6-scaled. This is TICK distance, not price: 50000 shifts the trigger by 5% of (tick_upper - tick_lower) ticks, which is not 5% of price. 0 = trigger exactly at the boundary. Positive (e.g. 50000) puts the trigger outside the position so price must travel further beyond the range before rebalancing. Negative (e.g. -50000) puts it inside, firing preemptively while price is still in range."
                      },
                      "trigger_upper_tick_ratio": {
                        "type": "integer",
                        "default": 0,
                        "description": "Same as trigger_lower_tick_ratio, for tick_upper. The two are independent, so asymmetric configs are valid (e.g. lower -50000, upper 0 rebalances early on the downside but only at the boundary on the upside)."
                      },
                      "min_rebalance_time": {
                        "type": "integer",
                        "default": 3600,
                        "description": "Cooldown in seconds between rebalances."
                      },
                      "max_rebalance_time": {
                        "type": "integer",
                        "default": 1000000000000,
                        "description": "Seconds before a rebalance is forced. Default is effectively disabled."
                      }
                    },
                    "required": [
                      "kind"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "const": "protocol_owned_liquidity"
                      },
                      "initial_range": {
                        "type": "integer",
                        "default": 200000
                      },
                      "base_range": {
                        "type": "integer",
                        "default": 50000
                      },
                      "k1": {
                        "type": "integer",
                        "default": 0
                      },
                      "k2": {
                        "type": "integer",
                        "default": 0
                      },
                      "rebalance_threshold": {
                        "type": "integer",
                        "default": 25000
                      },
                      "limit_order_withdrawal_threshold": {
                        "type": "integer",
                        "default": 50000
                      },
                      "fraction_excess_to_limit_order": {
                        "type": "integer",
                        "default": 500000
                      },
                      "deadzone": {
                        "type": "integer",
                        "default": 20000
                      },
                      "target_token0_ratio": {
                        "type": "integer",
                        "default": 500000
                      }
                    },
                    "required": [
                      "kind"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "const": "take_profit"
                      },
                      "profit_token": {
                        "type": "string",
                        "enum": [
                          "token0",
                          "token1"
                        ],
                        "default": "token0"
                      },
                      "take_profit_trigger_type": {
                        "type": "string",
                        "enum": [
                          "",
                          "fixed",
                          "relative"
                        ],
                        "default": "fixed"
                      },
                      "take_profit_trigger_threshold": {
                        "type": "integer",
                        "default": 0
                      },
                      "take_profit_reposition_mode": {
                        "type": "string",
                        "enum": [
                          "",
                          "anchor_tick",
                          "shift_range"
                        ],
                        "default": "anchor_tick"
                      },
                      "has_reversal": {
                        "type": "boolean",
                        "default": false
                      },
                      "reversal_trigger_type": {
                        "type": "string",
                        "enum": [
                          "",
                          "fixed",
                          "relative"
                        ],
                        "default": ""
                      },
                      "reversal_trigger_threshold": {
                        "type": "integer",
                        "default": 0
                      },
                      "reversal_reposition_mode": {
                        "type": "string",
                        "enum": [
                          "",
                          "anchor_tick",
                          "shift_range"
                        ],
                        "default": ""
                      }
                    },
                    "required": [
                      "kind"
                    ],
                    "additionalProperties": false
                  }
                ],
                "default": {
                  "kind": "out_of_range"
                },
                "description": "out_of_range repositions when price leaves the range; take_profit runs on the dedicated profit-taker contract; protocol_owned_liquidity is the POL strategy."
              },
              "max_tolerance": {
                "type": "integer",
                "minimum": 0,
                "maximum": 1000000000000000000,
                "description": "Max price deviation (MEV/slippage cap), 1e18-scaled: 1e18 = 100%, so 5000000000000000 = 0.5% (the default) and 50000000000000000 = 5%. Omit for the pool's default. AAA pools are floored at 5%."
              },
              "min_liquidity_ratio": {
                "type": "integer",
                "minimum": 0,
                "maximum": 1000000000000000000,
                "description": "Min fraction of liquidity that must survive a rebalance, 1e18-scaled: 990000000000000000 = 99% (the default), i.e. at most 1% value loss. Omit for the default."
              }
            },
            "required": [
              "kind"
            ],
            "additionalProperties": false
          }
        ],
        "description": "One user-facing automation intent."
      },
      "minItems": 1,
      "description": "Complete desired automation state. In save mode anything omitted is disabled, so include every automation to keep. A single intent with enabled: false disables all automations."
    },
    "mode": {
      "type": "string",
      "enum": [
        "save",
        "preview"
      ],
      "default": "save",
      "description": "save diffs against on-chain state and returns a signable transaction that also disables anything omitted. preview resolves and validates only, returning a plan and no transaction."
    },
    "position_id": {
      "type": "integer",
      "description": "LP position (NFT) id, as listed in assets[] by read.account.info. Supply this and the backend fetches protocol, staked flag, tokens and reward tokens for you. Strongly preferred over passing the position fields by hand."
    },
    "protocol": {
      "type": "string",
      "enum": [
        "slipstream_v1",
        "slipstream_v2",
        "slipstream_v3",
        "uniswap_v3",
        "uniswap_v4",
        "slipstream",
        "staked_slipstream",
        "staked_slipstream_v2",
        "staked_slipstream_v3",
        "uniV3",
        "uniV4"
      ],
      "description": "Position's DEX protocol. Only needed when position_id is omitted. Accepts the dex_protocol values the read tools return (slipstream, staked_slipstream_v3, uniV3, ...), which imply is_staked, as well as the canonical slipstream_v1 / uniswap_v3 spellings."
    },
    "is_staked": {
      "type": "boolean",
      "description": "Whether the LP position is staked. Implied by a staked_* protocol value."
    },
    "token0": {
      "type": "string",
      "description": "Pool token0 address."
    },
    "token1": {
      "type": "string",
      "description": "Pool token1 address."
    },
    "reward_tokens": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Staking reward token addresses."
    },
    "owner": {
      "type": "string",
      "description": "Account owner EOA. Used to resolve wallet payout targets."
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "required": [
    "account_address",
    "intents"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

write_account_automations_delta

Apply an explicit change to an account's automations and return the unsigned setAssetManagers transaction. Unlike write_account_automations this is a delta, not a full desired state: automations you do not mention are left untouched. Use it to switch one automation on or off without restating the others. The enable array takes intents to switch on (same shapes as write_account_automations). To turn an automation OFF, call read_asset_manager_current, take the address of the manager serving it, and pass that address in the disable array: an intent with enabled: false in `enable` is rejected because the backend would ignore it. Superseded or unreadable managers still set on the account are force-disabled in the same transaction regardless. Intents: - compound_fees: reinvest earned fees/rewards back into the LP. Optional 'tokens' scopes it per yielding token. A staked reward that is not a pool token is swapped in via CowSwap automatically. - claim_rewards: claim yield out. config.mode as_earned pays the tokens as-is, convert_to swaps them to config.buy_token via CowSwap. config.convert_tokens converts only a subset and claims the rest as-earned. config.destination account or wallet. - add_to_lp: fold idle pool-token balances (deposits, rebalance leftovers) back into the LP. Opt-in per token. - claim_merkl: auto-claim Merkl incentive rewards. Independent of the compounder/claimer/cowswapper triad and needs no position context. - rebalance: reposition the LP. strategy out_of_range (default), take_profit (runs on the dedicated profit-taker contract), or protocol_owned_liquidity. Pass position_id (from assets[] in read_account_info) and the backend fills in protocol, is_staked, token0, token1 and reward_tokens for you; anything you pass explicitly wins. claim_merkl needs no position context. Rules the backend enforces (a violation is returned as an error, never written on-chain): - Every yielding token must be assigned to exactly one of compound_fees or claim_rewards. Scoping one to a subset without covering the rest is rejected, and no token may be in both. - A wallet or custom-recipient payout requires a pure as-earned claim: nothing converted, and every yielding token claimed. Converts settle in the account. - convert_tokens must be a subset of the claimed tokens, and buy_token cannot be a compounded token, a converted token, or an add_to_lp folded token. - Each intent kind may appear only once, and a token list must not be empty or name a token the position does not yield.

Parameters11

account_address	string	required	Arcadia account address
enable	array	optional	Intents to switch on. Leave empty when only disabling. This array cannot turn anything off: an entry with enabled: false is rejected, use `disable` instead.
disable	array	optional	Asset-manager addresses to switch off, as returned by read.asset_manager.current.
position_id	integer	optional	LP position (NFT) id, as listed in assets[] by read.account.info. Supply this and the backend fetches protocol, staked flag, tokens and reward tokens for you. Strongly preferred over passing the position fields by hand.
protocol	string	optional	Position's DEX protocol. Only needed when position_id is omitted. Accepts the dex_protocol values the read tools return (slipstream, staked_slipstream_v3, uniV3, ...), which imply is_staked, as well as the canonical slipstream_v1 / uniswap_v3 spellings.
is_staked	boolean	optional	Whether the LP position is staked. Implied by a staked_* protocol value.
token0	string	optional	Pool token0 address.
token1	string	optional	Pool token1 address.
reward_tokens	array	optional	Staking reward token addresses.
owner	string	optional	Account owner EOA. Used to resolve wallet payout targets.
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "account_address": {
      "type": "string",
      "description": "Arcadia account address"
    },
    "enable": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "compound_fees"
              },
              "enabled": {
                "type": "boolean",
                "default": true,
                "description": "False disables this intent's managers instead of enabling them."
              },
              "position_id": {
                "type": "integer",
                "description": "LP position (NFT) id this intent applies to. Also used to auto-fetch position context."
              },
              "tokens": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "token0",
                    "token1",
                    "reward"
                  ]
                },
                "description": "Which tokens' yield to reinvest. Omit for all yielding tokens. 'reward' only exists on a staked position whose reward token is not a pool token. Every yielding token must be assigned to either compound_fees or claim_rewards, so if you scope this to a subset you must add a claim_rewards intent covering the rest."
              }
            },
            "required": [
              "kind"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "claim_rewards"
              },
              "enabled": {
                "$ref": "#/properties/enable/items/anyOf/0/properties/enabled"
              },
              "position_id": {
                "$ref": "#/properties/enable/items/anyOf/0/properties/position_id"
              },
              "config": {
                "type": "object",
                "properties": {
                  "mode": {
                    "type": "string",
                    "enum": [
                      "as_earned",
                      "convert_to"
                    ],
                    "default": "as_earned",
                    "description": "as_earned pays out the claimed tokens as-is; convert_to swaps them to buy_token via CowSwap. Use convert_tokens to convert only some of them."
                  },
                  "destination": {
                    "type": "string",
                    "enum": [
                      "account",
                      "wallet"
                    ],
                    "default": "account",
                    "description": "Payout target ('wallet' is the owner EOA). A wallet payout is only allowed for a pure as-earned claim: nothing converted, and every yielding token claimed. Any convert, or a claim scoped to a subset of tokens, must use 'account' because CowSwap settles there."
                  },
                  "buy_token": {
                    "type": "string",
                    "description": "ERC20 to swap into. Required whenever any token is being converted. It cannot be a token you also compound, one of the tokens being converted, or a token folded by add_to_lp."
                  },
                  "recipient": {
                    "type": "string",
                    "description": "Explicit payout address. Overrides destination when set, and is subject to the same pure-as-earned rule as a wallet payout unless it equals the account address."
                  },
                  "tokens": {
                    "type": "array",
                    "items": {
                      "$ref": "#/properties/enable/items/anyOf/0/properties/tokens/items"
                    },
                    "description": "Which tokens' yield to claim out. Omit for all yielding tokens. A token cannot be both claimed and compounded, and every yielding token must be assigned to one of the two."
                  },
                  "convert_tokens": {
                    "type": "array",
                    "items": {
                      "$ref": "#/properties/enable/items/anyOf/0/properties/tokens/items"
                    },
                    "description": "Subset of this intent's claimed tokens to swap to buy_token; the rest are claimed as-earned. Must be a subset of `tokens`. Omit to defer to mode (convert_to converts all claimed tokens, as_earned converts none). Use this for a partial convert, e.g. tokens: ['token0','reward'] with convert_tokens: ['reward'] swaps only the reward and claims token0 as-is."
                  }
                },
                "additionalProperties": false,
                "default": {}
              }
            },
            "required": [
              "kind"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "add_to_lp"
              },
              "enabled": {
                "$ref": "#/properties/enable/items/anyOf/0/properties/enabled"
              },
              "position_id": {
                "$ref": "#/properties/enable/items/anyOf/0/properties/position_id"
              },
              "tokens": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "token0",
                    "token1"
                  ]
                },
                "description": "Which pool tokens' idle account balance to fold into the LP. Omit for both. Folding is opt-in per token, and a folded token cannot be the buy_token of a claim_rewards convert."
              }
            },
            "required": [
              "kind"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "claim_merkl"
              },
              "enabled": {
                "$ref": "#/properties/enable/items/anyOf/0/properties/enabled"
              },
              "position_id": {
                "$ref": "#/properties/enable/items/anyOf/0/properties/position_id"
              },
              "config": {
                "type": "object",
                "properties": {
                  "destination": {
                    "type": "string",
                    "enum": [
                      "account",
                      "wallet"
                    ],
                    "default": "account"
                  },
                  "reward_recipient": {
                    "type": "string",
                    "description": "Explicit recipient address. Overrides destination when set."
                  }
                },
                "additionalProperties": false,
                "default": {}
              }
            },
            "required": [
              "kind"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "rebalance"
              },
              "enabled": {
                "$ref": "#/properties/enable/items/anyOf/0/properties/enabled"
              },
              "position_id": {
                "$ref": "#/properties/enable/items/anyOf/0/properties/position_id"
              },
              "strategy": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "const": "out_of_range"
                      },
                      "optimal_token0_ratio": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 1000000,
                        "default": 500000,
                        "description": "Target token0 composition after a rebalance, 1e6-scaled: 500000 = 50% (balanced, the default), 750000 = 75% token0, 0 = all token1."
                      },
                      "trigger_lower_tick_ratio": {
                        "type": "integer",
                        "default": 0,
                        "description": "Offset from tick_lower as a fraction of the position's tick range, 1e6-scaled. This is TICK distance, not price: 50000 shifts the trigger by 5% of (tick_upper - tick_lower) ticks, which is not 5% of price. 0 = trigger exactly at the boundary. Positive (e.g. 50000) puts the trigger outside the position so price must travel further beyond the range before rebalancing. Negative (e.g. -50000) puts it inside, firing preemptively while price is still in range."
                      },
                      "trigger_upper_tick_ratio": {
                        "type": "integer",
                        "default": 0,
                        "description": "Same as trigger_lower_tick_ratio, for tick_upper. The two are independent, so asymmetric configs are valid (e.g. lower -50000, upper 0 rebalances early on the downside but only at the boundary on the upside)."
                      },
                      "min_rebalance_time": {
                        "type": "integer",
                        "default": 3600,
                        "description": "Cooldown in seconds between rebalances."
                      },
                      "max_rebalance_time": {
                        "type": "integer",
                        "default": 1000000000000,
                        "description": "Seconds before a rebalance is forced. Default is effectively disabled."
                      }
                    },
                    "required": [
                      "kind"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "const": "protocol_owned_liquidity"
                      },
                      "initial_range": {
                        "type": "integer",
                        "default": 200000
                      },
                      "base_range": {
                        "type": "integer",
                        "default": 50000
                      },
                      "k1": {
                        "type": "integer",
                        "default": 0
                      },
                      "k2": {
                        "type": "integer",
                        "default": 0
                      },
                      "rebalance_threshold": {
                        "type": "integer",
                        "default": 25000
                      },
                      "limit_order_withdrawal_threshold": {
                        "type": "integer",
                        "default": 50000
                      },
                      "fraction_excess_to_limit_order": {
                        "type": "integer",
                        "default": 500000
                      },
                      "deadzone": {
                        "type": "integer",
                        "default": 20000
                      },
                      "target_token0_ratio": {
                        "type": "integer",
                        "default": 500000
                      }
                    },
                    "required": [
                      "kind"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "const": "take_profit"
                      },
                      "profit_token": {
                        "type": "string",
                        "enum": [
                          "token0",
                          "token1"
                        ],
                        "default": "token0"
                      },
                      "take_profit_trigger_type": {
                        "type": "string",
                        "enum": [
                          "",
                          "fixed",
                          "relative"
                        ],
                        "default": "fixed"
                      },
                      "take_profit_trigger_threshold": {
                        "type": "integer",
                        "default": 0
                      },
                      "take_profit_reposition_mode": {
                        "type": "string",
                        "enum": [
                          "",
                          "anchor_tick",
                          "shift_range"
                        ],
                        "default": "anchor_tick"
                      },
                      "has_reversal": {
                        "type": "boolean",
                        "default": false
                      },
                      "reversal_trigger_type": {
                        "type": "string",
                        "enum": [
                          "",
                          "fixed",
                          "relative"
                        ],
                        "default": ""
                      },
                      "reversal_trigger_threshold": {
                        "type": "integer",
                        "default": 0
                      },
                      "reversal_reposition_mode": {
                        "type": "string",
                        "enum": [
                          "",
                          "anchor_tick",
                          "shift_range"
                        ],
                        "default": ""
                      }
                    },
                    "required": [
                      "kind"
                    ],
                    "additionalProperties": false
                  }
                ],
                "default": {
                  "kind": "out_of_range"
                },
                "description": "out_of_range repositions when price leaves the range; take_profit runs on the dedicated profit-taker contract; protocol_owned_liquidity is the POL strategy."
              },
              "max_tolerance": {
                "type": "integer",
                "minimum": 0,
                "maximum": 1000000000000000000,
                "description": "Max price deviation (MEV/slippage cap), 1e18-scaled: 1e18 = 100%, so 5000000000000000 = 0.5% (the default) and 50000000000000000 = 5%. Omit for the pool's default. AAA pools are floored at 5%."
              },
              "min_liquidity_ratio": {
                "type": "integer",
                "minimum": 0,
                "maximum": 1000000000000000000,
                "description": "Min fraction of liquidity that must survive a rebalance, 1e18-scaled: 990000000000000000 = 99% (the default), i.e. at most 1% value loss. Omit for the default."
              }
            },
            "required": [
              "kind"
            ],
            "additionalProperties": false
          }
        ],
        "description": "One user-facing automation intent."
      },
      "default": [],
      "description": "Intents to switch on. Leave empty when only disabling. This array cannot turn anything off: an entry with enabled: false is rejected, use `disable` instead."
    },
    "disable": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "default": [],
      "description": "Asset-manager addresses to switch off, as returned by read.asset_manager.current."
    },
    "position_id": {
      "type": "integer",
      "description": "LP position (NFT) id, as listed in assets[] by read.account.info. Supply this and the backend fetches protocol, staked flag, tokens and reward tokens for you. Strongly preferred over passing the position fields by hand."
    },
    "protocol": {
      "type": "string",
      "enum": [
        "slipstream_v1",
        "slipstream_v2",
        "slipstream_v3",
        "uniswap_v3",
        "uniswap_v4",
        "slipstream",
        "staked_slipstream",
        "staked_slipstream_v2",
        "staked_slipstream_v3",
        "uniV3",
        "uniV4"
      ],
      "description": "Position's DEX protocol. Only needed when position_id is omitted. Accepts the dex_protocol values the read tools return (slipstream, staked_slipstream_v3, uniV3, ...), which imply is_staked, as well as the canonical slipstream_v1 / uniswap_v3 spellings."
    },
    "is_staked": {
      "type": "boolean",
      "description": "Whether the LP position is staked. Implied by a staked_* protocol value."
    },
    "token0": {
      "type": "string",
      "description": "Pool token0 address."
    },
    "token1": {
      "type": "string",
      "description": "Pool token1 address."
    },
    "reward_tokens": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Staking reward token addresses."
    },
    "owner": {
      "type": "string",
      "description": "Account owner EOA. Used to resolve wallet payout targets."
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "required": [
    "account_address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

dev_send

DEV ONLY — Sign and broadcast an unsigned transaction using a local private key (PK env var). For production, use a dedicated wallet MCP server (Fireblocks, Safe, Turnkey, etc.) instead of this tool. Takes the transaction object returned by any write.* tool and submits it onchain.

Parameters4

to	string	required	Target contract address
data	string	required	Encoded calldata (hex)
value	string	optional	Value in wei (default '0')
chain_id	number	optional	Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)

Raw schema

{
  "type": "object",
  "properties": {
    "to": {
      "type": "string",
      "description": "Target contract address"
    },
    "data": {
      "type": "string",
      "description": "Encoded calldata (hex)"
    },
    "value": {
      "type": "string",
      "default": "0",
      "description": "Value in wei (default '0')"
    },
    "chain_id": {
      "type": "number",
      "default": 8453,
      "description": "Chain ID: 8453 (Base), 130 (Unichain), or 10 (Optimism)"
    }
  },
  "required": [
    "to",
    "data"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md16 KBView on GitHub

Arcadia Finance MCP Server

arcadia-finance-mcp-server MCP server

MCP server for Arcadia Finance, a platform for concentrated liquidity on Uniswap and Aerodrome with automated rebalancing, compounding, yield optimization, and leverage, or single-sided liquidity into lending pools. Read protocol data and build unsigned transactions for LP management, borrowing, deposits, and more.

Designed for AI agents (Claude, Cursor, etc.) to interact with Arcadia onchain.

Install

Tools

Read Tools

Tool	Description
`read.account.info`	Account overview: health factor, collateral, debt, positions, liquidation price, automation status.
`read.account.history`	Historical account value over time.
`read.account.pnl`	PnL and yield data for an account.
`read.wallet.accounts`	List all Arcadia accounts owned by a wallet address.
`read.wallet.balances`	On-chain ERC20 balances and native ETH for a wallet address.
`read.wallet.allowances`	Check ERC20 token allowances for a spender. Use before `write.wallet.approve` to avoid redundant approvals.
`read.wallet.points`	Points balance for a specific wallet address.
`read.asset.list`	Supported collateral assets with addresses, types, decimals.
`read.asset.prices`	USD prices for one or more asset addresses.
`read.pool.list`	All lending pools: TVL, APY, utilization, liquidity.
`read.pool.info`	Single pool detail with APY history over time.
`read.point_leaderboard`	Paginated Arcadia points leaderboard.
`read.strategy.list`	LP strategies with APY, underlyings, pool info. Supports featured filter and pagination.
`read.strategy.info`	Full detail for a specific LP strategy: APY per range width, pool config.
`read.strategy.recommendation`	Rebalancing recommendation for an account.
`read.guides`	Reference guides: automation setup, strategy selection, strategy templates.
`read.asset_manager.intents`	Automation intents and their params; add `account_address` for live per-account availability.
`read.asset_manager.current`	Automations enabled on an account: decoded config, mapped intents, Merkl state, superseded managers.

Write Tools

All write tools return unsigned transactions as { to, data, value, chainId }.

Tool	Description
`write.wallet.approve`	Approve an ERC20 token for spending. Required before depositing into an account. Call `read.wallet.allowances` first to check if already approved.
`write.pool.deposit`	Lend the pool's underlying asset into an ERC-4626 tranche to earn interest. Mints tranche shares to the receiver.
`write.pool.redeem`	Redeem tranche shares back into the underlying asset (lender exit).
`write.account.create`	Create a new Arcadia account via Factory.
`write.account.deposit`	Deposit ERC20 tokens into an account.
`write.account.withdraw`	Withdraw assets from an account.
`write.account.borrow`	Borrow from a lending pool.
`write.account.repay`	Repay debt to a lending pool from wallet.
`write.account.add_liquidity`	Flash-action: deposit + swap + mint LP + optional leverage, atomically.
`write.account.remove_liquidity`	Remove/decrease LP position liquidity.
`write.account.swap`	Swap assets within an account (backend-routed).
`write.account.deleverage`	Repay debt by selling collateral (swap + repay in one tx).
`write.account.close`	Atomic close: burn LP + swap + repay debt in one tx.
`write.account.stake`	Stake, unstake, or claim rewards for LP positions.
`write.account.automations`	Configure automations from an intents array (full desired state). Returns the unsigned setAssetManagers tx.
`write.account.automations_delta`	Enable/disable individual automations, leaving the rest untouched.

Dev Tools

Always registered but requires PK env var to function.

Tool	Description
`dev.send`	Sign and broadcast an unsigned transaction using a local private key (`PK` env var). Not for production — use a dedicated wallet MCP server instead.

Transaction Signing

All write tools return unsigned transactions as { to, data, value, chainId }. This server does NOT sign or broadcast — your agent or application is responsible for that.

Options

Wallet MCP servers (recommended for production): Pair this server with a wallet MCP server that handles signing:

Wallet MCP	Provider	Model
MCP Wallet Signer	Community	Non-custodial, routes to browser wallet (MetaMask, Rabby)
Coinbase AgentKit	Coinbase	Wallet-agnostic, supports multiple providers
Phantom MCP	Phantom	Embedded wallet
Privy MCP	Privy	Wallet infrastructure
Safe MCP	Community	Multi-sig via Safe

Or use your existing wallet setup (Fireblocks, Dfns, Turnkey, Biconomy, Dynamic) and pass the unsigned tx object to your provider's signing method.

viem/ethers in your agent:

typescript

import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { base } from "viem/chains";

const account = privateKeyToAccount("0x...");
const client = createWalletClient({ account, chain: base, transport: http() });

// tx = result from any write.* tool
const hash = await client.sendTransaction(tx);

Built-in dev.send tool (development only): The server includes a dev-only signing tool that reads a private key from the PK environment variable. Set PK via a .env file or your MCP client config:

bash

# .env in the server directory (never commit — already gitignored)
PK=0xYourPrivateKeyHex
RPC_URL_BASE=https://base-mainnet.g.alchemy.com/v2/your-key

The server loads .env automatically on startup. Works with any MCP client (Claude Desktop, Claude Code, VSCode, Cursor). MCP client env block settings take precedence if both are set.

Not for production — use a dedicated wallet MCP server (Fireblocks, Turnkey, Safe) instead.

Setup

Prerequisites: Node.js >= 22

bash

yarn install
yarn build

Environment variables:

Variable	Required	Default	Transport	Description
`RPC_URL_BASE`	No	Public RPC	Both	RPC URL for Base (8453).
`RPC_URL_UNICHAIN`	No	Public RPC	Both	RPC URL for Unichain (130).
`RPC_URL_OPTIMISM`	No	Public RPC	Both	RPC URL for Optimism (10).
`RPC_URL_ROBINHOOD`	No	Public RPC	Both	RPC URL for Robinhood (4663).
`PK`	No	—	Both	Private key (hex) for dev-only `dev.send` tool.
`TRANSPORT`	No	`stdio`	—	Transport mode: `stdio` or `http`.
`PORT`	No	`3000`	HTTP	Listen port for HTTP transport.
`ALLOWED_ORIGINS`	No	`https://mcp.arcadia.finance`	HTTP	Comma-separated allowed Origin headers (CORS / DNS rebinding).
`RATE_LIMIT_RPM`	No	`60`	HTTP	Max requests per minute per session.

Supported chains: Base (8453), Unichain (130), Optimism (10), Robinhood (4663)

MCP Client Configuration

Remote (no install needed):

json

{
  "mcpServers": {
    "arcadia-finance": {
      "url": "https://mcp.arcadia.finance/mcp"
    }
  }
}

Via npx (local stdio):

json

{
  "mcpServers": {
    "arcadia-finance": {
      "command": "npx",
      "args": ["-y", "@arcadia-finance/mcp-server"],
      "env": {
        "RPC_URL_BASE": "https://base-mainnet.g.alchemy.com/v2/your-key"
      }
    }
  }
}

Claude Code:

bash

# Remote
claude mcp add arcadia-finance --transport http https://mcp.arcadia.finance/mcp

# Local
claude mcp add arcadia-finance -- npx -y @arcadia-finance/mcp-server

From source (local development):

json

{
  "mcpServers": {
    "arcadia-finance": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/dist/index.js"],
      "env": {
        "RPC_URL_BASE": "https://base-mainnet.g.alchemy.com/v2/your-key"
      }
    }
  }
}

Skills

The skills/ directory contains Claude Code skills that teach AI agents how to use this MCP server effectively. To install a skill, symlink it into your Claude skills directory:

bash

ln -s /path/to/mcp-server/skills/clamm-liquidity ~/.claude/skills/clamm-liquidity

Available skills:

Skill	Description
`clamm-liquidity`	Concentrated liquidity management: concepts, intent-based automation, and step-by-step workflows.

Reporting Issues

Found a bug, missing feature, or unclear documentation while using this server? Open an issue: https://github.com/arcadia-finance/mcp-server/issues

For AI agents: If you hit a gap during task execution, open an issue with:

Tool name and parameters you used
What you expected vs what happened
The strategy or goal you were trying to execute

Pull requests for documentation fixes are welcome from agents and humans alike. All PRs require human review before merging.

Where to Find Us

npm: @arcadia-finance/mcp-server
MCP Registry: registry.modelcontextprotocol.io
Smithery: smithery.ai
MCP Servers: mcpservers.org
LobeHub: lobehub.com
PulseMCP: pulsemcp.com
MCP Market: mcpmarket.com
Glama: glama.ai
awesome-mcp-servers: github.com/TensorBlock/awesome-mcp-servers

Development

bash

yarn dev          # Run with tsx (hot reload)
yarn build        # Compile TypeScript
yarn test         # Run tests
yarn lint         # Lint with ESLint
yarn format       # Check formatting with Prettier

Install

Tools (35)

read_account_inforead_account_historyread_account_pnlread_pool_listread_pool_inforead_asset_listread_asset_pricesread_strategy_list

Configuration

Environment variables

RPC_URL_BASEsecret

RPC URL for Base (8453). Falls back to public RPC if not set.

RPC_URL_UNICHAINsecret

RPC URL for Unichain (130). Falls back to public RPC if not set.

RPC_URL_OPTIMISMsecret

RPC URL for Optimism (10). Falls back to public RPC if not set.

PKsecret

Private key for dev-only signing (not for production).

TRANSPORT

Transport mode: stdio (default) or http.

PORT

HTTP listen port (default 3000). Only used when TRANSPORT=http.

ALLOWED_ORIGINS

Comma-separated allowed Origin headers for CORS and DNS rebinding protection. Only used when TRANSPORT=http.

RATE_LIMIT_RPM

Max requests per minute per session (default 60). Only used when TRANSPORT=http.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@arcadia-finance/mcp-server@0.5.1"
      ],
      "env": {
        "RPC_URL_BASE": "<YOUR_RPC_URL_BASE>",
        "RPC_URL_UNICHAIN": "<YOUR_RPC_URL_UNICHAIN>",
        "RPC_URL_OPTIMISM": "<YOUR_RPC_URL_OPTIMISM>",
        "PK": "<YOUR_PK>",
        "TRANSPORT": "<YOUR_TRANSPORT>",
        "PORT": "<YOUR_PORT>",
        "ALLOWED_ORIGINS": "<YOUR_ALLOWED_ORIGINS>",
        "RATE_LIMIT_RPM": "<YOUR_RATE_LIMIT_RPM>"
      }
    }
  }
}

Arcadia Finance MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

read_account_info

read_account_history

read_account_pnl

read_pool_list

read_pool_info

read_asset_list

read_asset_prices

read_strategy_list

read_strategy_info

read_strategy_recommendation

read_point_leaderboard

read_guides

read_wallet_balances

read_wallet_allowances

read_wallet_accounts

read_wallet_points

read_asset_manager_intents

read_asset_manager_current

write_account_create

write_account_deposit

write_account_withdraw

write_account_borrow

write_account_repay

write_account_add_liquidity

write_account_remove_liquidity

write_account_swap

write_account_deleverage

write_account_stake

write_account_close

write_wallet_approve

write_pool_deposit

write_pool_redeem

write_account_automations

write_account_automations_delta

dev_send

Arcadia Finance MCP Server

Install

Tools

Read Tools

Write Tools

Dev Tools

Transaction Signing

Options

Setup

MCP Client Configuration

Skills

Reporting Issues

Where to Find Us

Development

Install

Configuration

Related servers