Developers

REST API

Base URL https://api.algonexus.trade/v1. The live OpenAPI document is served at /openapi.json; interactive docs at /docs.

Core resources

Method	Path	Purpose
`POST`	`/v1/goals/feasibility`	Required growth rate, probability of reaching the target, and suggestions
`POST`	`/v1/policies`	Create a versioned investment policy (requires e-consent)
`GET`	`/v1/portfolio`	Cash, holdings and market value with timestamps
`POST`	`/v1/ideas/generate`	AI proposals, routed by mode
`POST`	`/v1/orders/{id}/approve`	Approve a proposed order (also /reject, /cancel)
`GET`	`/v1/reports/daily`	Daily accountability reports
`GET`	`/v1/brokers`	Broker catalogue and capabilities

Example

curl -s https://api.algonexus.trade/v1/goals/feasibility \
  -H "authorization: Bearer $ALGONEXUS_KEY" \
  -H "content-type: application/json" \
  -d '{"capital":10000,"target":20000,"horizon_years":5,"market":"US"}'

Errors and limits

Errors use RFC 9457 problem details with a stable type URI.
Rate limits are returned in RateLimit and RateLimit-Policy headers; 429 includes Retry-After.
All mutating requests accept an Idempotency-Key header.