Build with AI | Developer Docs

Use the Avo API to build AI-powered agents, bots, and integrations that create and manage portfolios programmatically. This page gives you everything you need to get started — whether you're prompting an LLM or wiring up an autonomous agent.

Tip for AI builders Feed the OpenAPI spec directly to your LLM or agent framework. It contains full endpoint definitions, parameter schemas, and response examples — everything needed to generate working API calls.

Downloads

OpenAPI Spec

openapi.json · 1.2.0

Postman Collection

Pre-configured requests

API Reference

Base URL: https://api.avo.so. Endpoints under /api/* require a JWT bearer token.

Health

GET/healthReturns the health status of the API. No authentication required.GET/pingReturns a simple pong response. Use this to verify the API is reachable. No authentication required.GET/api/healthAuthenticated health check endpoint. Returns the health status of the internal API services.AUTH

Portfolio

GET/api/portfolio/pingSimple ping to the portfolio service to verify connectivity. Requires JWT authentication.AUTH POST/api/portfolio/createCreates a new portfolio. Uses multipart/form-data to support optional image upload.AUTH POST/api/portfolio/updateUpdates the target positions for an existing portfolio. Target positions define the desired allocation of tokens in the portfolio.AUTH