Built for AI Agents
REST API, MCP Server, and verifiable track record. Your agent gets daily stock picks, fundamental research, and portfolio data — all structured for machine consumption.
Try it live →Explore every endpoint in your browser. No signup required.
Quick Start
1. Register for a free API key
curl -X POST https://vectorialdata.com/api/v1/auth/register \
-H "Content-Type: application/json" \
-d '{"name": "My Agent"}'2. Get latest picks
curl -H "Authorization: Bearer vd_live_YOUR_KEY" \ https://vectorialdata.com/api/v1/picks
3. Get research for a stock
curl -H "Authorization: Bearer vd_live_YOUR_KEY" \ https://vectorialdata.com/api/v1/research/UBS
Python Example
import requests
API_KEY = "vd_live_YOUR_KEY"
BASE = "https://vectorialdata.com/api/v1"
headers = {"Authorization": f"Bearer {API_KEY}"}
# Get all picks
picks = requests.get(f"{BASE}/picks", headers=headers).json()
for pick in picks["data"]:
print(f"{pick['ticker']}: {pick['return_pct']:+.1f}%")
# Get research
research = requests.get(f"{BASE}/research/AVGO", headers=headers).json()
print(research["data"]["summary_why"])
# Verify track record
ledger = requests.get(f"{BASE}/verify/picks").json()
print(f"Chain valid: {ledger['valid']}, {ledger['chain_length']} picks")API Endpoints
| Endpoint | Auth | Description |
|---|---|---|
| GET /info | Public | Service discovery |
| POST /auth/register | Public | Get free API key |
| GET /picks | API key | Stock picks with returns |
| GET /picks/latest | API key | Most recent pick |
| GET /research/{ticker} | API key | Full stock research |
| GET /portfolio | API key | Portfolio summary |
| GET /portfolio/positions | API key | All positions |
| GET /portfolio/history | API key | Daily snapshots |
| GET /sectors | API key | Sector allocation |
| GET /regions | API key | Region allocation |
| GET /stocks | API key | All researched stocks |
| GET /events | API key | Portfolio events (firehose with severity 1-5) |
| GET /economic-events | API key | Most relevant macro event of the day, analyzed (es/en/pt/hi) |
| GET /digest/latest | API key | Weekly digest (events + portfolio delta) |
| GET /verify/picks | Public | Verifiable hash chain |
All endpoints prefixed with /api/v1
API key billing
One prepaid USDC balance per API key. Each request debits the per-endpoint price (the same prices as the x402 table below). No tiers, no daily limits.
New keys start with a $0.20 USDC free trial balance.
Top up your balance with USDC via Stripe at the API keys dashboard (minimum 5 USDC).
x402 Pay-Per-Request
NEWNo API key needed. No registration. No subscription. Your AI agent pays USDC on Base per request and gets pro-tier data instantly. The payment IS the authentication.
GET /api/v1/x402/picks — server responds HTTP 402 with payment instructions
Agent pays USDC on Base to the address in the 402 response
Agent retries with payment proof in X-PAYMENT header
Server verifies via Coinbase facilitator — delivers pro-tier data. Agent only charged if successful.
| Endpoint | Price | Description |
|---|---|---|
| GET /x402/picks | $0.005 | All picks with returns |
| GET /x402/picks/latest | $0.001 | Latest pick |
| GET /x402/research/{ticker} | $0.01 | Full research report |
| GET /x402/portfolio | $0.002 | Portfolio summary |
| GET /x402/portfolio/positions | $0.003 | All positions |
| GET /x402/portfolio/history | $0.005 | Performance history |
| GET /x402/sectors | $0.001 | Sector breakdown |
| GET /x402/regions | $0.001 | Region breakdown |
| GET /x402/stocks | $0.005 | All researched stocks |
All endpoints prefixed with /api/v1. Discovery: GET /api/v1/x402/info. Powered by x402 protocol (Coinbase).
Integration Methods
REST API
Standard HTTP endpoints with JSON responses. Works with any language.
MCP Server
Native integration with Claude, GPT, and MCP-compatible agents.
npx @vectorialdata/mcp-server
Verifiable Track Record
Every pick is part of a SHA-256 hash chain committed to git. Agents can verify that no picks were edited retroactively.
# Verify the entire pick history curl https://vectorialdata.com/api/v1/verify/picks # Verify a specific pick curl https://vectorialdata.com/api/v1/verify/pick/UBS
Algorithm: SHA-256(ticker|price|date|previous_hash) — each pick chains to the previous