Built for AI Agents
REST API, MCP server and verifiable track record. Your agent gets the stock pick of every business day, fundamental research and model-portfolio data in percentages, 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
Public MCP server
Free · no authConnect Claude, ChatGPT or any MCP-compatible agent to Vectorial Data's public data. It is read-only, needs no sign-up or API key, and only returns announced picks, with the model portfolio in percentages.
Connect it from Claude Code:
claude mcp add --transport http vectorialdata https://vectorialdata.com/api/mcp
Any MCP client with the Streamable HTTP transport uses the same URL (JSON-RPC requests over POST). https://vectorialdata.com/api/mcp
Tools
get_latest_picks— The latest announced pick and the 4 before it: the same free view as /picks.get_stock_research— A stock's public page: summary, what it does, why it was picked, the main risk and the full research, in es, en, pt or hi.get_portfolio_summary— Model portfolio return vs the S&P 500 and the best and worst announced positions, in percentages only.verify_pick · get_verification_chain— Verify an announced pick in the hash chain and its attestation on Base, or download the whole chain to recompute it.list_economic_events · get_economic_event— Vectorial Economía: recent macro events and the full analysis of each one.
The same data the website shows without an account. Editorial information, not personalized investment advice.
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
A public, read-only remote MCP server for Claude, ChatGPT and MCP-compatible agents. No sign-up.
claude mcp add --transport http vectorialdata https://vectorialdata.com/api/mcp
Verifiable Track Record
Every announced pick is part of a SHA-256 hash chain and is attested on the Base blockchain. Agents can verify that no pick was edited after it was recorded.
# 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