Feito para Agentes de IA
REST API, MCP Server e registro verificável. Seu agente obtém picks diários de ações, pesquisa fundamental e dados de portfólio — tudo estruturado para consumo por máquinas.
Experimente ao vivo →Explore cada endpoint no seu navegador. Sem cadastro.
Início Rápido
1. Registre uma API key gratuita
curl -X POST https://vectorialdata.com/api/v1/auth/register \
-H "Content-Type: application/json" \
-d '{"name": "My Agent"}'2. Obtenha os últimos picks
curl -H "Authorization: Bearer vd_live_YOUR_KEY" \ https://vectorialdata.com/api/v1/picks
3. Obtenha pesquisa de uma ação
curl -H "Authorization: Bearer vd_live_YOUR_KEY" \ https://vectorialdata.com/api/v1/research/UBS
Exemplo em Python
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")Endpoints da API
| Endpoint | Auth | Descrição |
|---|---|---|
| GET /info | Público | Descoberta do serviço |
| POST /auth/register | Público | Obter API key gratuita |
| GET /picks | API key | Picks de ações com retornos |
| GET /picks/latest | API key | Pick mais recente |
| GET /research/{ticker} | API key | Pesquisa completa de ações |
| GET /portfolio | API key | Resumo do portfólio |
| GET /portfolio/positions | API key | Todas as posições |
| GET /portfolio/history | API key | Snapshots diários |
| GET /sectors | API key | Distribuição por setor |
| GET /regions | API key | Distribuição por região |
| GET /stocks | API key | Todas as ações pesquisadas |
| GET /events | API key | Eventos do portfólio (firehose com severidade 1-5) |
| GET /economic-events | API key | Análise do evento macro mais relevante do dia (es/en/pt/hi) |
| GET /digest/latest | API key | Digest semanal (eventos + delta do portfólio) |
| GET /verify/picks | Público | Cadeia de hashes verificável |
Todos os endpoints com prefixo /api/v1
Cobrança por chave de API
Um saldo pré-pago em USDC por chave de API. Cada requisição debita o preço do endpoint (os mesmos preços da tabela x402 abaixo). Sem planos, sem limites diários.
Chaves novas incluem um saldo de teste de $0,20 USDC.
Recarregue seu saldo com USDC via Stripe no painel de chaves de API (mínimo 5 USDC).
x402 Pagamento por Requisição
NOVOSem API key. Sem registro. Sem assinatura. Seu agente de IA paga USDC na Base por requisição e obtém dados de nível pro instantaneamente. O pagamento É a autenticação.
GET /api/v1/x402/picks — o servidor responde HTTP 402 com instruções de pagamento
O agente paga USDC na Base para o endereço na resposta 402
O agente tenta novamente com prova de pagamento no X-PAYMENT header
O servidor verifica via facilitador da Coinbase — entrega dados de nível pro. O agente só é cobrado se for bem-sucedido.
| Endpoint | Preço | Descrição |
|---|---|---|
| GET /x402/picks | $0.005 | Todos os picks com retornos |
| GET /x402/picks/latest | $0.001 | Último pick |
| GET /x402/research/{ticker} | $0.01 | Relatório de pesquisa completo |
| GET /x402/portfolio | $0.002 | Resumo do portfólio |
| GET /x402/portfolio/positions | $0.003 | Todas as posições |
| GET /x402/portfolio/history | $0.005 | Histórico de desempenho |
| GET /x402/sectors | $0.001 | Detalhamento por setor |
| GET /x402/regions | $0.001 | Detalhamento por região |
| GET /x402/stocks | $0.005 | Todas as ações pesquisadas |
Todos os endpoints com prefixo /api/v1. Discovery: GET /api/v1/x402/info. Powered by x402 protocol (Coinbase).
Métodos de Integração
REST API
Endpoints HTTP padrão com respostas JSON. Funciona com qualquer linguagem.
MCP Server
Integração nativa com Claude, GPT e agentes compatíveis com MCP.
npx @vectorialdata/mcp-server
Registro Verificável
Cada pick faz parte de uma cadeia de hashes SHA-256 registrada no git. Os agentes podem verificar que nenhum pick foi editado retroativamente.
# 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
Algoritmo: SHA-256(ticker|price|date|previous_hash) — cada pick se encadeia ao anterior
Precisa de ajuda para integrar? Escreva para Hello@vectorialdata.com