For AI Agents

Integration guide for AI agents interacting with Arcadia Protocol: chain deployments, key contract addresses, common read operations, account queries, and programmatic docs access via llms.txt.

This page provides a structured reference for AI agents, bots, and automated systems that need to interact with Arcadia Protocol programmatically.

Chain Deployments

Chain	Chain ID	Block Explorer
Base	8453	basescan.org
Optimism	10	optimistic.etherscan.io
Unichain	130	uniscan.xyz

The core protocol contracts (Factory, Registry, Liquidator) share the same addresses across chains.

Key Contract Addresses

These are the most commonly needed addresses for programmatic interaction. For the full list, see Contract Addresses.

Contract	Address	Purpose
Factory	0xDa14Fdd72345c4d2511357214c5B89A919768e59	Creates and manages Arcadia Accounts (ERC721)
Registry	0xd0690557600eb8Be8391D1d97346e2aab5300d5f	Asset/oracle module coordination, pricing orchestration
Liquidator	0xA4B0b9fD1d91fA2De44F6ABFd59cC14bA1E1a7Af	Dutch auctions for unhealthy account liquidation
LendingPool WETH	0x803ea69c7e87D1d6C86adeB40CB636cC0E6B98E2	WETH lending pool
LendingPool USDC	0x3ec4a293Fb906DD2Cd440c20dECB250DeF141dF1	USDC lending pool
LendingPool cbBTC	0xa37e9b4369dc20940009030bfbc2088f09645e3b	cbBTC lending pool

Common Tokens (Base)

Token	Address	Decimals
WETH	0x4200000000000000000000000000000000000006	18
USDC	0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913	6
cbBTC	0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf	8
AERO	0x940181a94A35A4569E4529A3CDfB74e38FD98631	18
AAA	0xaaa843fb2916c0B57454270418E121C626402AAa	18
stAAA	0xDeA1531d8a1505785eb517C7A28526443df223F3	18

Common Read Operations

Get total number of accounts

Factory(0xDa14...8e59).allAccountsLength() → uint256

Get account address by index

Factory(0xDa14...8e59).allAccounts(uint256 index) → address

Get account owner

Factory(0xDa14...8e59).ownerOf(uint256 accountId) → address

Check if an account is liquidatable

AccountV1(accountAddress).isAccountLiquidatable() → bool

Get account health (liquidation value vs used margin)

AccountV1(accountAddress).getLiquidationValue() → uint256
AccountV1(accountAddress).getUsedMargin() → uint256

A healthy account has liquidationValue > usedMargin.

Get account assets

AccountV1(accountAddress).generateAssetData() → (address[] assets, uint256[] assetIds, uint256[] assetAmounts)

Get asset value in a numeraire

Registry(0xd069...d5f).getTotalValue(address numeraire, address creditor, address[] assets, uint256[] assetIds, uint256[] assetAmounts) → uint256

Arcadia API

The Arcadia REST API provides off-chain data for accounts, pools, and asset prices. Base URL: https://api.arcadia.finance/v1/api

Endpoint	Description
GET /pools?chain_id=8453	List all lending pools
GET /assets?chain_id=8453	List all supported assets
GET /price?chain_id=8453&asset=<address>	Get asset price
GET /accounts?chain_id=8453	List all accounts

No API key is required.

Programmatic Docs Access

The full documentation is available in machine-readable format:

• Structured summary: docs.arcadia.finance/llms.txt

• Full content: docs.arcadia.finance/llms-full.txt

MCP Server

The Arcadia MCP Server lets AI agents interact with the protocol through the Model Context Protocol. It provides tools to read account data, pool stats, and strategies, and to build unsigned transactions for deposits, borrowing, liquidity management, and more. See the MCP Server page for setup instructions and the full tool reference.

Source Code

Repository	Description
accounts-v2	Account contracts, Registry, Asset Modules, Oracle Modules
lending-v2	Lending Pools, Tranches, Liquidator
asset-managers	Compounders, Rebalancers, Yield Claimers, CoW Swapper, Merkl Operators
mcp-server	MCP Server for AI agent integration
whitepapers	Protocol whitepaper