/investing

name: investing
description: "Investing.com via HTML scrape: cotizaciones, historico OHLCV, fundamentals (income/balance/cashflow/ratios), dividendos, earnings, perfil de empresa. 81K+ equities, 344 commodities, 10K indices, 2.4K currencies, 10K ETFs, 4.1K cryptos. Cobertura global."
license: MIT

Investing.com — Datos via HTML Scrape

Skill para extraer datos de [Investing.com](https://www.investing.com) parseando el HTML publico. Sin API key, sin autenticacion.

---

⚠️ Aviso Legal y Tecnico

• Investing.com **no expone API publica**. Los datos se extraen de las paginas HTML con Cloudflare bot protection.
• **Dependencia obligatoria:** `curl_cffi` (impersona Chrome 120 a nivel TLS — `requests` puro devuelve el challenge de Cloudflare, no datos).
• **Rate limit agresivo:** respetar 1-2 segundos entre requests. Cloudflare devuelve 429/403 si se hacen muchas requests muy rapido. El script reintenta con backoff automatico.
• **Datos delayed:** el precio mostrado en la pagina es el del ultimo cierre disponible (15-20 min de delay para US equities, similar para otros).
• **Respetar terminos de servicio** de Investing.com. No hacer mas de 1-2 requests/segundo. No usar para redistribuir masivamente.
• Investing.com se reserva el derecho de bloquear rangos de IP. El skill puede dejar de funcionar en cualquier momento.

---

Scripts

| Script | Descripcion | |--------|-------------| | **[fetch_investing.py](./scripts/fetch_investing.py)** | Script principal: todos los modos disponibles |

---

Instalacion de dependencias

pip install curl_cffi

> NO funciona con `requests` puro. Cloudflare detecta y bloquea.

---

Uso rapido

# === COTIZACIONES (auto-detect tipo) ===
python scripts/fetch_investing.py quote gold
python scripts/fetch_investing.py quote eur-usd
python scripts/fetch_investing.py quote us-spx-500
python scripts/fetch_investing.py quote bitcoin
python scripts/fetch_investing.py quote ypf-sa --type equities
python scripts/fetch_investing.py quote apple-computer-inc -q

# === BUSQUEDA EN SITEMAPS ===
python scripts/fetch_investing.py search YPF
python scripts/fetch_investing.py search gold --category commodities
python scripts/fetch_investing.py search MERVAL --category indices
python scripts/fetch_investing.py search AR --category currencies --limit 30

# === SITEMAPS COMPLETOS ===
python scripts/fetch_investing.py sitemap commodities    # 344 instrumentos
python scripts/fetch_investing.py sitemap currencies     # 2,394 cruces
python scripts/fetch_investing.py sitemap indices        # 20K+ indices
python scripts/fetch_investing.py sitemap equities       # 81K+ acciones
python scripts/fetch_investing.py sitemap etfs           # 30K+ ETFs

# === HISTORICO OHLCV ===
python scripts/fetch_investing.py historical gold
python scripts/fetch_investing.py historical eur-usd
python scripts/fetch_investing.py historical ypf-sa --pages 5  # ~115 dias
python scripts/fetch_investing.py historical apple-computer-inc

# === FUNDAMENTALS ===
python scripts/fetch_investing.py profile apple-computer-inc
python scripts/fetch_investing.py financials apple-computer-inc --ftype income
python scripts/fetch_investing.py financials apple-computer-inc --ftype balance
python scripts/fetch_investing.py financials apple-computer-inc --ftype cashflow
python scripts/fetch_investing.py ratios apple-computer-inc
python scripts/fetch_investing.py dividends apple-computer-inc
python scripts/fetch_investing.py earnings apple-computer-inc

# === GUARDAR A ARCHIVO ===
python scripts/fetch_investing.py quote gold -o gold_quote.json
python scripts/fetch_investing.py historical ypf-sa -o ypf_hist.json

# === MODO SILENCIOSO (solo JSON, sin logs) ===
python scripts/fetch_investing.py quote gold -q

---

Modos disponibles

| Modo | Data | Endpoint | |------|------|----------| | `quote` | Cotizacion (precio, cambio, OHLC, volume, pair_id) | `www.investing.com/{type}/{slug}` | | `search` | Busqueda fuzzy sobre sitemaps publicos | Sitemap XMLs | | `sitemap` | Descarga sitemap completo (URLs de instrumentos) | Sitemap XMLs | | `historical` | Historico OHLCV desde la tabla HTML | `/{type}/{slug}-historical-data` | | `profile` | Descripcion, sector, industria, pais, sede, empleados | `/{type}/{slug}-company-profile` | | `financials` | Income / Balance / Cash Flow (TTM + ultimos 5 anios) | `/{type}/{slug}-income-statement` etc. | | `ratios` | Margenes, retornos, valuation ratios | `/{type}/{slug}-ratios` | | `dividends` | Historial completo de dividendos | `/{type}/{slug}-dividends` | | `earnings` | Earnings history (EPS real vs estimado) | `/{type}/{slug}-earnings` |

---

Tipos de instrumentos

| Tipo | `--type` | Slug example | Cobertura | |------|----------|--------------|-----------| | Equity (stock/ADR) | `equities` | `apple-computer-inc`, `ypf-sa`, `ggal` | 81,518 | | Commodity | `commodities` | `gold`, `crude-oil`, `brent-oil` | 344 | | Indice | `indices` | `us-spx-500`, `ibovespa`, `dax` | 20,000+ | | Currency pair (forex) | `currencies` | `eur-usd`, `usd-ars`, `brl-usd` | 2,394 | | ETF | `etfs` | `spdr-s-p-500`, `vanguard-ftse-all-world` | 30,000+ | | Crypto | `crypto` | `bitcoin`, `ethereum` | 4,135+ coins, 20K+ pairs | | Tasa / Bono | `rates-bonds` | (no en sitemap directo) | 20,000+ | | Fondo | `funds` | (no en sitemap directo) | 100K+ | | Certificado | `certificates` | (no en sitemap directo) | 6,222 |

> **Auto-deteccion:** si no pasas `--type`, el script prueba commodities → currencies → indices → etfs → crypto → equities. Las equities son las mas lentas/rate-limited, asi que se prueban al final.

---

Slugs utiles (Argentina / LatAm)

| Slug | Nombre | Simbolo | Tipo | |------|--------|---------|------| | `ypf-sa` | YPF Sociedad Anonima | YPF | equities | | `ypf-sociedad` | YPF Sociedad (variante) | YPF | equities | | `pampa-energia` | Pampa Energia SA | PAMPm | equities | | `pampa-energia-sa` | Pampa Energia ADR | PAM | equities | | `central-puerto` | Central Puert