API Reference

The VecTrade API is organized around REST. All requests use https://api.vectrade.io/v1 as the base URL and return JSON responses.

Base URL

https://api.vectrade.io/v1

Authentication

All endpoints require an API key via the X-API-Key header:

X-API-Key: vq_your_key_here

Get your key at vectrade.io/vtrade/developer. See the Authentication Guide for key management best practices.

Endpoint Groups

Market Data

Real-time quotes, fundamentals, technicals, news, historical prices, and ETF data.

Research & Analysis

Analyst ratings, price targets, earnings, insider trades, sentiment, and company profiles.

Options

Full options chains with Greeks and expiration data.

Portfolio Intelligence

Financial statements, balance sheets, and key ratios for fundamental analysis.

Quick Summary

Use the endpoint pages in this section as the primary reference. Each page binds to an OpenAPI operation via its openapi frontmatter key, so the method/path mapping is validated against the checked-in spec.

SDKs

Don’t want to work with raw HTTP? Use our official SDKs:

Python

pip install vectrade

TypeScript

npm install @vectrade/sdk

Go CLI

brew install VecTrade-io/vectrade/vectrade

FinKit

pip install vectrade-finkit

MCP Server

AI IDE integration

AI Provider

Vercel AI SDK

Rate Limits

Plan	Requests/min	Requests/day
Free	30	1,000
Pro	300	50,000
Enterprise	Custom	Custom

See Rate Limits Guide for optimization strategies.

Errors

All errors return a consistent JSON structure:

{
  "error": {
    "type": "rate_limit_error",
    "message": "Rate limit exceeded",
    "request_id": "req_abc123",
    "retry_after": 2
  }
}

See Error Handling Guide for the full error taxonomy and retry strategies.

API Reference

Market Data

AI & Analysis

Options & Events

Developer

API Reference

API Reference

Base URL

Authentication

Endpoint Groups

Market Data

Research & Analysis

Options

Portfolio Intelligence

Quick Summary

SDKs

Python

TypeScript

Go CLI

FinKit

MCP Server

AI Provider

Rate Limits

Errors

​API Reference

​Base URL

​Authentication

​Endpoint Groups

Market Data

Research & Analysis

Options

Portfolio Intelligence

​Quick Summary

​SDKs

Python

TypeScript

Go CLI

FinKit

MCP Server

AI Provider

​Rate Limits

​Errors

API Reference

Base URL

Authentication

Endpoint Groups

Quick Summary

SDKs

Rate Limits

Errors