Overview

Integration options

Owney provides two ways to integrate DeFi Agents into your application, depending on the level of customization you need.

1. White-label UI integration

Quickly integrate DeFi Agents using our pre-built white-label interface. This option allows you to launch quickly with minimal development effort while benefiting from Owney’s infrastructure. You can customize the UI and embed it directly into your application, for example as an “AI Agents” or “DeFi Earn” section. (See White-label UI)

2. Full SDK integration

Build your own interface on top of the Owney SDK for full control over the user experience. This option allows you to create custom UI and user flows while aligning with your existing product.

Owney SDK

The Owney SDK is a TypeScript library that helps you integrate DeFi agents into your application with a consistent API.

The SDK abstracts:

• Wallet connection
• Smart wallet deployment
• Session key management
• Agent & strategy selection
• Agent execution
• Portfolio & earnings tracking

Wallet connection

Users interact with DeFi Agents through Owney by connecting their own wallet. Agents run on top of the user’s wallet. The SDK is non-custodial and does not manage custody of user funds. All interactions are executed through the user’s wallet, and the SDK never requires or accesses user private keys.

Each deployed agent creates its own smart wallet or smart account through which all agent actions are executed. This ensures agent interactions remain isolated while still operating on top of the user’s connected wallet.

Requirements

To use the SDK, your application must:

1. Integrate an EVM-Compatible wallet solution (e.g. MetaMask, Privy, Coinbase Wallet, etc.).
2. Obtain an EIP-1193-compatible provider from that wallet. (See Examples)

The SDK uses the provider to:

• Request wallet connection
• Sign authentication messages (e.g. SIWE, if required)
• Deploy smart wallets (when needed)
• Approve and execute transactions
• Manage session keys for delegated agent actions

Connection flow

1. Call connect once at the start of a user session.
2. Use isConnected to guard wallet-dependent UI/actions.
3. Call disconnect when ending the session.

Most SDK methods require an active connection.

Account setup and activation

Use account lifecycle methods to prepare a user for agent execution:

• activateAgent deploys the user smart wallet and initializes session context for an agent.

Fund operations

Use the fund methods to move capital into and out of agent strategies:

• deposit
• withdraw

Portfolio monitoring

Use portfolio methods to fetch performance data and account views:

• getBalances — Current allocations and balances.
• getEarnings — Earnings summary.
• getAccountApy — Weighted APY across portfolio or per agent.
• getHistory — Transaction and rebalance history.
• getUserProfile — User-level agent profile data.

Agent performance

Get insights into the overall performance of agents. A wallet connection is not required to use these functions.

• getAgentApy for the overall APY of one or all agents.