Hecho para Agentes de IA
REST API, MCP Server y registro verificable. Tu agente obtiene picks diarios de acciones, research fundamental y datos de portafolio — todo estructurado para consumo por máquinas.
Inicio Rápido
1. Registra una API key gratuita
curl -X POST https://vectorialdata.com/api/v1/auth/register \
-H "Content-Type: application/json" \
-d '{"name": "My Agent"}'2. Obtén los últimos picks
curl -H "Authorization: Bearer vd_live_YOUR_KEY" \ https://vectorialdata.com/api/v1/picks
3. Obtén research de una acción
curl -H "Authorization: Bearer vd_live_YOUR_KEY" \ https://vectorialdata.com/api/v1/research/UBS
Ejemplo en 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 de la API
| Endpoint | Auth | Descripción |
|---|---|---|
| GET /info | Público | Descubrimiento del servicio |
| POST /auth/register | Público | Obtener API key gratuita |
| GET /picks | API key | Picks de acciones con retornos |
| GET /picks/latest | API key | Pick más reciente |
| GET /research/{ticker} | API key | Research completo de acciones |
| GET /portfolio | API key | Resumen del portafolio |
| GET /portfolio/positions | API key | Todas las posiciones |
| GET /portfolio/history | API key | Snapshots diarios |
| GET /sectors | API key | Distribución por sector |
| GET /regions | API key | Distribución por región |
| GET /stocks | API key | Todas las acciones investigadas |
| GET /verify/picks | Público | Cadena de hashes verificable |
| POST /payments/verify | API key | Verificar pago USDC |
Todos los endpoints con prefijo /api/v1
Gratis
$0
- 10 solicitudes/día
- Últimos 3 picks
- Resumen del portafolio
- Lista básica de acciones
- Verificación del historial
Pro
5 USDC/mes
- 1,000 solicitudes/día
- Todos los picks (historial completo)
- Reportes de research completos
- Datos históricos completos
- Verificación del historial
Paga con USDC en Base L2
x402 Pago por Solicitud
NUEVOSin API key. Sin registro. Sin suscripción. Tu agente de IA paga USDC en Base por solicitud y obtiene datos de nivel pro al instante. El pago ES la autenticación.
GET /api/v1/x402/picks — el servidor responde HTTP 402 con instrucciones de pago
El agente paga USDC en Base a la dirección en la respuesta 402
El agente reintenta con prueba de pago en X-PAYMENT header
El servidor verifica vía facilitador de Coinbase — entrega datos de nivel pro. El agente solo paga si tiene éxito.
| Endpoint | Precio | Descripción |
|---|---|---|
| GET /x402/picks | $0.005 | Todos los picks con retornos |
| GET /x402/picks/latest | $0.001 | Último pick |
| GET /x402/research/{ticker} | $0.01 | Reporte de research completo |
| GET /x402/portfolio | $0.002 | Resumen del portafolio |
| GET /x402/portfolio/positions | $0.003 | Todas las posiciones |
| GET /x402/portfolio/history | $0.005 | Historial de rendimiento |
| GET /x402/sectors | $0.001 | Desglose por sector |
| GET /x402/regions | $0.001 | Desglose por región |
| GET /x402/stocks | $0.005 | Todas las acciones investigadas |
Todos los endpoints con prefijo /api/v1. Discovery: GET /api/v1/x402/info. Powered by x402 protocol (Coinbase).
Pago de Suscripción
- Envía 5 USDC en Base L2 a nuestra dirección de wallet
- Copia el hash de la transacción
- Llama a
POST /api/v1/payments/verifycon tu API key y tx_hash - Tu key se actualiza instantáneamente a Pro por 30 días
curl -X POST https://vectorialdata.com/api/v1/payments/verify \
-H "Authorization: Bearer vd_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"tx_hash": "0x..."}'Métodos de Integración
REST API
Endpoints HTTP estándar con respuestas JSON. Funciona con cualquier lenguaje.
MCP Server
Integración nativa con Claude, GPT y agentes compatibles con MCP.
npx @vectorialdata/mcp-server
Registro Verificable
Cada pick es parte de una cadena de hashes SHA-256 registrada en git. Los agentes pueden verificar que ningún pick fue editado retroactivamente.
# 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 encadena al anterior
¿Preguntas? Contáctanos en vectorialdata.com