API Reference
Complete REST API documentation for AgentBank. All endpoints use JSON for request and response bodies.
Base URL
Base URLurl
/api/v1All API requests should be made to your deployment base URL + /api/v1.
Authentication
All API requests require a Bearer token via your API key. Include the header in every request:
Request Headerhttp
Authorization: Bearer agentbank_live_xxxCreate and manage API keys from the Dashboard → API Keys.
Rate Limits
API requests are rate-limited per API key. Contact support for higher limits. Rate limit headers are included in responses.
Response Format
All responses use JSON. Success responses return the requested data. Error responses include a message and optional code.
Endpoints Overview
| Method | Path | Description |
|---|---|---|
| POST | /v1/ventures | Create a new venture |
| GET | /v1/ventures/:venture_id | Get venture details |
| POST | /v1/ventures/:venture_id/treasury | Create treasury wallet (idempotent) |
| GET | /v1/ventures/:venture_id/treasury | Get treasury details |
| GET | /v1/ventures/:venture_id/balances | Get ETH, USDC, ADAO balances |
| GET | /v1/ventures/:venture_id/ledger | Get ledger entries (paginated) |
| POST | /v1/ventures/:venture_id/inflows | Register inbound transfer from external system |
| GET | /v1/ventures/:venture_id/inflows | Get inflow entries (filterable by source) |
| GET | /v1/ventures/:venture_id/outflows | Get outflow entries (alias for ledger direction=out) |
| POST | /v1/ventures/:venture_id/transfers | Create transfer/payout |