Skip to content
Berry Docs
For developers

API and integration

Berry exposes a public API and contract surface that anyone, including AI agents, can read and interact with. Read endpoints do not require authentication, and all writes happen directly on chain.

Base URL

https://api.berryfinance.site

Public read endpoints

  • GET /api/config: Platform wide configuration.
  • GET /api/pools: List all pools, filterable by status.
  • GET /api/pools/:poolAddress: Single pool details.
  • GET /api/pools/:poolAddress/investors: Investor list for a pool.
  • GET /api/tokens/:tokenAddress: All pools for a given token.
  • GET /api/portfolio/:walletAddress: All positions for a wallet.
  • GET /api/pools/:poolAddress/nectar/:walletAddress: Nectar earnings history.

Data encoding conventions

  • All times are unix seconds.
  • All percentages are basis points, where 1000 = 10% and 6000 = 60%.
  • All amounts, including ETH, USDG, and tokens, are wei strings, not floats.
  • All market cap values are 6 decimal USDG equivalents encoded as strings.

Smart contract addresses

Published on Contracts and Addresses, which is the only page that carries them.