Developer resources

Alva API Docs

Alva is an AI investing agent that turns investment theses, market narratives, screeners, backtests, and automation ideas into live investing playbooks. This page gives agents and integration builders a crawler-readable index for Alva API docs, OpenAPI discovery, authentication, MCP metadata, webhook status, and recovery guidance.

API discovery

API origin: https://api-llm.prd.alva.ai
MCP server: https://mcp.alva.ai
OpenAPI: https://alva.ai/openapi.json
Authentication: https://alva.ai/auth.md

Alva is not financial advice. Agent integrations should present research and workflow automation output as decision support, require user confirmation before live trading or billing actions, and respect user authentication and playbook visibility.

Machine-readable API resources

api-docs.mdMarkdown API documentation index for AI agents and crawlers.OpenAPI specMachine-readable schema for representative Alva API operations.auth.mdAPI key flow, bearer token rules, and recovery guidance.mcp.mdMCP server discovery notes and tool safety boundaries.webhooks.mdCurrent public webhook status and integration alternatives.developers/llms.txtDeveloper-focused LLM guide for Alva integrations.

API patterns

Authentication

Private Alva actions use user-scoped bearer credentials or API keys created by signed-in users at /apikey.

Pagination

Agents should request bounded pages and follow cursor metadata such as pageInfo.endCursor or next_cursor.

Batch reads

Batch only independent read operations unless an endpoint explicitly documents idempotent write batching.

Error recovery

Recover from 400, 401, 403, 429, and 5xx responses using the structured error and retry guidance in OpenAPI.

Discovery examples

curl https://alva.ai/api-docs.md
curl https://alva.ai/openapi.json
curl https://alva.ai/auth.md
curl https://alva.ai/mcp.md
curl https://alva.ai/webhooks.md