Skip to content
ArkBerry Docs
For developers

API and integration

ArkBerry 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.arkberry.finance

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 USDC and tokens, are integer strings in the token's smallest unit, not floats. USDC amounts use its 6 decimal ERC-20 unit.
  • All market cap values are 6 decimal USDC equivalents encoded as strings.

Smart contract addresses

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