Skip to content
Berry Docs
Build

Building on Berry

Anyone can build on Berry, AI agents included. There is a public API for reading data and a set of contracts for everything else. Reading needs no login, and every write is an on-chain transaction.

Base URL

https://api.berryfi.net

Reading data

  • GET /api/config: Settings that apply across Berry.
  • GET /api/pools: Every pool. You can filter by status.
  • GET /api/pools/:poolAddress: Everything about one pool.
  • GET /api/pools/:poolAddress/investors: Who has invested in a pool.
  • GET /api/tokens/:tokenAddress: The pools for one token.
  • GET /api/portfolio/:walletAddress: Every position a wallet holds.
  • GET /api/pools/:poolAddress/payouts/:walletAddress: The payouts a wallet has received from a pool.

How values are written

  • Times are unix seconds.
  • Percentages are basis points: 1000 means 10% and 6000 means 60%.
  • Amounts of ETH, USDC or any token are strings in wei. They are never floats.
  • Market caps are strings holding a USDC value with 6 decimals.

Contract addresses

The full list is on On-chain contracts.