VectorialDATA

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 auth

Connect 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

EndpointAuthDescription
GET /infoPublicService discovery
POST /auth/registerPublicGet free API key
GET /picksAPI keyStock picks with returns
GET /picks/latestAPI keyMost recent pick
GET /research/{ticker}API keyFull stock research
GET /portfolioAPI keyPortfolio summary
GET /portfolio/positionsAPI keyAll positions
GET /portfolio/historyAPI keyDaily snapshots
GET /sectorsAPI keySector allocation
GET /regionsAPI keyRegion allocation
GET /stocksAPI keyAll researched stocks
GET /eventsAPI keyPortfolio events (firehose with severity 1-5)
GET /economic-eventsAPI keyMost relevant macro event of the day, analyzed (es/en/pt/hi)
GET /digest/latestAPI keyWeekly digest (events + portfolio delta)
GET /verify/picksPublicVerifiable hash chain

All endpoints prefixed with /api/v1

Try all endpoints in the API playground →

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

NEW

No 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.

1

GET /api/v1/x402/picks — server responds HTTP 402 with payment instructions

2

Agent pays USDC on Base to the address in the 402 response

3

Agent retries with payment proof in X-PAYMENT header

4

Server verifies via Coinbase facilitator — delivers pro-tier data. Agent only charged if successful.

EndpointPriceDescription
GET /x402/picks$0.005All picks with returns
GET /x402/picks/latest$0.001Latest pick
GET /x402/research/{ticker}$0.01Full research report
GET /x402/portfolio$0.002Portfolio summary
GET /x402/portfolio/positions$0.003All positions
GET /x402/portfolio/history$0.005Performance history
GET /x402/sectors$0.001Sector breakdown
GET /x402/regions$0.001Region breakdown
GET /x402/stocks$0.005All 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

OpenAPI Spec

Auto-generate client libraries from our spec.

Download openapi.yaml

llms.txt

Machine-readable service description for LLM crawlers.

View llms.txt

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

Need help integrating? Email us at Hello@vectorialdata.com