Desarrolladores

Compara carteras de ETF, consulta el historial de informes y entrega exportaciones con versiones desde una API.

Prueba la API sin clave

Prueba la demo sin clave. Usa tu propia clave para consultar los datos completos.

GET /v1/demo
curl --fail-with-body 'https://etflayers.com/v1/demo'
Respuesta de ejemplo · extracto
{
  "comparison": {
    "common_count": 3,
    "demonstration": true,
    "methodology": "nport-common-equity-v1",
    "overlap_pct": 60.0
  }
}

QQQ / SPY · Solapamiento de posiciones

Integra la API con tu clave

as_of acota la fecha de la cartera. known_at limita los informes a aquellos cuya disponibilidad está registrada en el archivo. En cargas antiguas, la primera observación puede ser posterior a la publicación original.

cURL
cURL
curl 'https://etflayers.com/es/compare/qqq-vs-spy/sample.json'
curl 'https://etflayers.com/v1/overlap?funds=QQQ,SPY&as_of=2026-06-30' -H 'Authorization: Bearer YOUR_API_KEY'
curl 'https://etflayers.com/v1/overlap/history?funds=QQQ,SPY' -H 'Authorization: Bearer YOUR_API_KEY'
curl -X POST 'https://etflayers.com/v1/exports' -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: my-qqq-spy-export-1' \
  -H 'Content-Type: application/json' -d '{"funds":["QQQ","SPY"],"format":"parquet"}'
Python
Python
import os
import requests

api_key = os.environ["ETFLAYERS_API_KEY"]
response = requests.get("https://etflayers.com/v1/overlap",
    params={"funds": "SPY,QQQ"}, headers={"Authorization": f"Bearer {api_key}"}, timeout=15)
response.raise_for_status()
print(response.json()["overlap_pct"])
JavaScript (Node.js)
JavaScript (Node.js)
const apiKey = process.env.ETFLAYERS_API_KEY;
const r = await fetch("https://etflayers.com/v1/overlap?funds=SPY,QQQ", {
  headers: { Authorization: "Bearer " + apiKey },
});
if (!r.ok) throw new Error("HTTP " + r.status);
console.log((await r.json()).overlap_pct);
Claves de API

Identificadores de clases de acciones

security_id es el identificador que ETFLayers asigna a cada clase de acciones. Úsalo para enlazar carteras, comparaciones, informes CSV y exportaciones. Distintas clases de una misma empresa pueden tener identificadores diferentes.

Encuentra ETF que tienen una posición común de QQQ y SPY
cURL + jq
SECURITY_ID=$(curl -fsS 'https://etflayers.com/v1/overlap?funds=QQQ,SPY&limit=1' \
  -H "Authorization: Bearer $ETFLAYERS_API_KEY" | jq -er '.positions[0].security_id') && \
curl -fsS "https://etflayers.com/v1/securities/$SECURITY_ID/funds" \
  -H "Authorization: Bearer $ETFLAYERS_API_KEY"

Cada ETF aporta su cartera más reciente. Las fechas pueden variar entre fondos. Consulta report_date.

Webhooks y exportaciones programadas

Con un plan de API de pago, registra una dirección HTTPS aprobada para recibir avisos firmados con un identificador estable. Cada aviso enlaza con los fondos, las fechas y las versiones afectadas. Consulta GET /v1/webhooks/deliveries para ver los reintentos.

Los planes Growth y Distribution pueden programar archivos CSV o Parquet. GET /v1/export-schedule muestra la próxima ejecución y la última exportación. Puedes recuperarla aunque no hayas recibido el aviso.

cURL
Webhooks y exportaciones programadas
curl -X PUT 'https://etflayers.com/v1/webhooks' \
  -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"url":"https://webhooks.example.com/etflayers"}'
curl -X PUT 'https://etflayers.com/v1/export-schedule' \
  -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"funds":["QQQ","SPY"],"format":"parquet","interval":"week"}'
curl 'https://etflayers.com/v1/export-schedule' -H 'Authorization: Bearer YOUR_API_KEY'
Referencia OpenAPI