Prueba la API sin clave
Prueba la demo sin clave. Usa tu propia clave para consultar los datos completos.
curl --fail-with-body 'https://etflayers.com/v1/demo'
{
"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 '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
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)
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);
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
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
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'