Documentation Index
Fetch the complete documentation index at: https://docs.illa.io/llms.txt
Use this file to discover all available pages before exploring further.
ILLA aggregates financial operations into a unified execution surface.
Instead of integrating with individual protocols directly, AI systems connect to ILLA and gain access to a growing set of financial capabilities across chains, protocols, and asset types.
Every capability flows through the same core pipeline:
This means every new integration automatically inherits ILLA’s full safety stack.
Intent to execution
The power of ILLA’s capability surface is composition. The intelligence layer takes a single intent and decomposes it into a coordinated, multi-step, multi-chain plan across multiple capabilities.
Treasury operations.
Pull enough from our earning balance to cover today's invoices,
consolidate to USDC, and pay each one on the required network.
Query
Queries portfolio balances and DeFi positions, calculates the required withdrawal amount
Withdraw
Withdraws from lending protocol
Swap
Swaps withdrawn assets to USDC
Bridge
Bridges to each recipient’s network
Transfer
Executes individual transfers
Sell half my ETH, put $800 into yield, and use the rest to bet
on the Fed holding rates.
Query
Queries balances, calculates 50% of ETH holdings
Swap
Executes swap to USDC
Supply
Calculates split, supplies the majority to lending protocol for yield
Bridge
Bridges remainder to prediction market network
Position
Resolves target market by natural language, places position
Rebalance to 60% stablecoins in yield and 40% ETH, using the
best rates across chains.
Query
Queries full portfolio and existing positions
Calculate
Calculates target allocations against current holdings
Rebalance
Withdraws from existing lending positions, executes swaps to reach target ratios
Compare
Queries yield rates across chains and protocols
Supply
Supplies stablecoins to highest-yield protocol on optimal network
Capability reference
What ILLA can execute today, and what’s coming next.
Transfers and payments
Move value between addresses, across chains, and between networks.
| Capability | Description |
|---|
| Token Transfer | Send any supported asset to any address |
| Cross-Chain Bridge | Move assets between networks via aggregated routing |
Trading
Exchange assets at the best available rate across aggregated liquidity.
| Capability | Description |
|---|
| Token Swap | Exchange any token for another. Same-chain or cross-chain. Supports batched multi-swap execution in a single plan |
DeFi lending and yield
Supply assets to earn yield and manage positions across lending protocols.
| Capability | Description |
|---|
| Supply | Deposit assets into lending protocols to earn yield |
| Withdraw | Retrieve supplied assets and accrued yield |
Prediction markets
Take positions on real-world events through decentralised prediction markets.
| Capability | Description |
|---|
| Market Search | Find markets and odds by topic using natural language |
| Buy Outcome | Purchase outcome shares in an active market |
| Sell Position | Exit an existing position |
| Redeem Winnings | Claim returns from resolved markets |
Portfolio and positions
Query balances, positions, and portfolio state across chains and protocols.
| Capability | Description |
|---|
| Portfolio Balances | View asset balances across all supported networks |
| DeFi Positions | Query active lending and yield positions |
| Supported Tokens | Retrieve available tokens per network |
| Supported Capabilities | Discover what ILLA can execute |
Market intelligence
Access real-time pricing, yield data, and market information.
| Capability | Description |
|---|
| Token Prices | Current and historical asset pricing |
| DeFi Market Rates | Yield rates and lending conditions across protocols |
| Market Details | Odds, volume, and status for prediction markets |
Expansion
ILLA’s capability set is expanding continuously. The integration pattern is repeatable: define capability mappings, implement protocol adapters, vet for security and reliability, and activate.
Capabilities in development include: fiat gateway (on-ramp and off-ramp between fiat and digital assets, fiat-to-fiat transfers via traditional rails), tokenised equities (tokenised exposure to traditional equity markets) and perpetuals (leveraged long and short positions).
As new asset types and financial products come online, ILLA integrates them.
Supported networks
ILLA operates across multiple EVM-compatible networks. Capabilities are not chain-specific. A user can express intent without specifying a chain, and ILLA resolves the optimal execution path.
| Network | Type |
|---|
| Ethereum | L1 |
| Base | L2 |
| Optimism | L2 |
| Arbitrum | L2 |
| Polygon | L1 |
| Avalanche | L1 |
| BSC | L1 |
Adding capabilities
Every new integration follows the same process. The protocol is evaluated for reliability and security. Capability mappings are defined. Protocol adapters are implemented and tested against ILLA’s evaluation pipeline. The integration is activated and immediately inherits the full safety stack: simulation, verification, policy enforcement, and approval flows.
Integrators can scope their ILLA instance to specific capabilities, protocols, chains, or asset types. By default, ILLA routes through the full set of integrated protocols for optimal execution. These preferences are defined at the integration level and enforced by the Engine.
