API Overview

Getting started with the NexusTrade REST API and MCP Server

NexusTrade API & MCP Server

The NexusTrade API gives you programmatic access to all platform features — from creating and backtesting portfolios to running Aurora AI agents. You can use it via REST API or MCP (Model Context Protocol) for AI tool integration.

Step 1: Generate an API Key

Go to your Developers page
Enter a name and click Create
Copy the key immediately — it won't be shown again

Step 2: Connect

Option A: MCP Server (Claude Code, Claude Desktop, Cursor)

NexusTrade provides an MCP server that exposes Aurora's tools (stock screening, portfolio creation, backtesting, deep research, etc.) directly to your AI assistant.

Option B: REST API

Use your API key in the Authorization header. The versioned SDK API lives
under /api/v1/nexustrade; SDK clients take the base URL through
/api/v1 and append /nexustrade themselves:

curl -H "Authorization: Bearer sk-your-key" \
  https://nexustrade.io/api/v1/nexustrade/lake/catalog

API Surfaces

Versioned SDK base URL: https://nexustrade.io/api/v1
Versioned SDK routes: /api/v1/nexustrade/*
Remote MCP server: https://nexustrade.io/api/mcp
Legacy platform REST routes: /api/* (documented separately below)

Use the official Python SDK (pip install nexustrade, source) or TypeScript SDK (npm install nexustrade, source) for typed portfolio jobs and durable lake SQL. See SDK v1 for the HTTP routes those packages wrap, or the Developers page for a keyed quickstart.
Lake callers write read-only SQL against lake.*; NexusTrade resolves the
backing engine server-side and returns bounded Parquet parts.

Rate Limits

API requests are rate-limited to 60 requests per minute per user.

Response Format

All responses are JSON. Successful responses return a 200 (or 201 for creation) status code. Errors include a message field:

{ "message": "Error description" }