Developers

Build on the AlpaTrade agent desk.

Call the primary LangChain DeepAgent, research analysts, backtester, validator, paper trader, reconciler, reporter, and durable autonomy pipeline through typed APIs.

https://api.alpatrade.chat
Agent API referenceTry in Swagger
13callable agent interfaces
5capability groups
2JWT and service-key auth modes
Papertrading safety boundary
Agent catalogue

Choose the right specialist for the job.

Every agent below is callable through a typed HTTP contract. Skills describe stable capabilities; follow the reference link for request bodies, response schemas, examples, authentication, and error responses.

DeepAgent interfaces

2 agents

DeepAgent Assistant

POST

Primary LangChain DeepAgents harness with research and broker tools.

POST /v2/agents/chat/invoke
Portfolio and position analysisMarket news and company researchBacktest and reporting tool routingPaper-account workflow assistance
authenticated·synchronous·paper onlySchema & examples →

DeepAgent Assistant (SSE)

POST

Streaming DeepAgents chat with token, route, and tool events.

POST /v2/chat
Token-by-token conversational responsesAgent routing eventsTool execution eventsConversation-thread continuity
public·streaming·paper onlySchema & examples →

Research agents

4 agents

Premarket Agent

POST

Read-only premarket scan and ranked mover intelligence.

POST /v2/agents/premarket/invoke
Premarket mover discoveryCatalyst and news synthesisCandidate rankingSaved-scan retrieval
authenticated·synchronous·read onlySchema & examples →

Alpha Growth Agent

POST

Evidence-backed growth-company research report.

POST /v2/agents/alpha-growth/invoke
Growth-quality assessmentFundamental evidence collectionCatalyst and risk analysisPersistent research reports
authenticated·synchronous·read onlySchema & examples →

Alpha Value Agent

POST

Evidence-backed value-company research report.

POST /v2/agents/alpha-value/invoke
Valuation and margin-of-safety reviewFundamental evidence collectionCatalyst and risk analysisPersistent research reports
authenticated·synchronous·read onlySchema & examples →

Alpha Comparison Agent

POST

Growth and value views generated from one shared evidence collection.

POST /v2/agents/alpha-compare/invoke
Shared-evidence company researchGrowth-versus-value comparisonThesis conflict identificationPaired persistent reports
authenticated·synchronous·read onlySchema & examples →

Analysis and validation

3 agents

Backtest Agent

POST

Run the parameter-grid backtest and return the best configuration.

POST /v2/backtest
Strategy parameter sweepsHistorical performance analysisRisk and drawdown metricsBest-configuration selection
authenticated·synchronous·read onlySchema & examples →

Validation Agent

POST

Validate stored backtest or paper trades against market data.

POST /v2/validate
Trade-price verificationAnomaly detectionFill correction checksValidation suggestions
authenticated·synchronous·read onlySchema & examples →

Report Agent

GET

Return run summaries, detail, P&L, and ranked strategies.

GET /v2/report
Run summary reportingP&L breakdownsStrategy rankingPerformance metric retrieval
authenticated·synchronous·read onlySchema & examples →

Paper trading operations

2 agents

Paper Trade Agent

POST

Start a durable paper-trading subprocess and return immediately.

POST /v2/paper
Durable paper-strategy executionConfigurable polling and durationPDT-aware trade controlsBackground run monitoring
authenticated·asynchronous·paper onlySchema & examples →

Reconciliation Agent

POST

Compare the position ledger with the linked Alpaca paper account.

POST /v2/reconcile
Position-ledger reconciliationTrade mismatch detectionMissing and extra fill checksBroker-versus-database P&L comparison
authenticated·synchronous·paper onlySchema & examples →

Agent orchestration

2 agents

Five-Agent Orchestrator

POST

Run backtest, validation, paper trading, and reporting as one workflow.

POST /v2/full
Multi-agent workflow coordinationBacktest-to-paper promotionPhase status aggregationEnd-to-end run reporting
authenticated·synchronous·orchestrationSchema & examples →

Autonomy Scout

POST

Scan candidates and enqueue the durable paper-only agent pipeline.

POST /v2/agents/autonomy-scout/invoke
Market candidate scoutingStrategy-aware candidate rankingDurable autonomy-run enqueueingPaper-only account isolation
authenticated·asynchronous·paper onlySchema & examples →
Documentation

Human guides and machine contracts.

Use ReDoc for reading and Swagger UI for interactive calls. OpenAPI and catalogue JSON remain machine-readable for SDK generators, agents, and service discovery.

API
Agent reference
Browse agent skills, request schemas, responses, and safety boundaries.
Agent API docs →
API
Swagger UI
Authorize, compose requests, and call every typed endpoint interactively.
Open API explorer →
API
Complete ReDoc
Search the complete, grouped API contract in a clean reference layout.
Browse all endpoints →

Machine-readable: OpenAPI JSON · Agent catalogue JSON

Authentication

User JWTs and service API keys.

User clients send an Authorization bearer token obtained from /auth/login. Trusted services send X-API-Key and include X-User-Id when acting for a user. All trading and autonomy routes are paper-only.