Skip to main content

API

Earn has a public HTTP API, so AI agents and applications can do what the app does without a browser.

What it lets you do​

  • Read ranked vaults, your strategies and their positions, wallet balances, and cross-chain bridge status.
  • Create a strategy and close one.
  • Get ready-to-sign transactions. Token approvals, deposits, and withdrawals come back as prepared transaction data that your wallet signs and broadcasts.

Earn stays non-custodial. The API only ever hands back transactions for you to sign; it never holds your keys or moves funds on its own.

Authorization​

Reads are open, and so is asking for ready-to-sign transactions: the API only ever hands back unsigned transaction data, so nothing happens on-chain until your wallet signs and broadcasts it. Creating or closing a strategy is authorized by a per-action wallet signature, the same Sign-In-with-Ethereum signature the app uses. There are no API keys or logins: the wallet that signs is the owner.

For developers​

A full OpenAPI 3.1 specification is the reference for every endpoint, unit, and error, and recipes cover headless signing, the complete create-to-close lifecycle, and polling for status. Agents can generate their own tools directly from the spec.