Skip to main content

​
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

PlanRequests/minRequests/day
Free301,000
Pro30050,000
EnterpriseCustomCustom
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.