How portfolIQ calculates stock metadata consensus
SEC EDGAR as primary source, data quality, coverage, and Phase 1 limitations for US equity metadata.
How portfolIQ calculates stock metadata consensus
Disclaimer: Data provided by portfolIQ is factual and descriptive. It does not constitute financial advice, investment recommendations, or any form of guidance on buying, selling, or holding any financial instrument. Not financial advice. Methodology disclosed.
Primary source: SEC EDGAR
All US equity metadata served by portfolIQ originates from SEC EDGAR (the Electronic Data Gathering, Analysis, and Retrieval system operated by the U.S. Securities and Exchange Commission).
EDGAR is explicitly in the public domain under 17 CFR §200.80. portfolIQ redistributes derived data commercially under this basis. Every API response includes meta.source_primary: "edgar_xbrl_v1" and meta.licensed_for_commercial_use: true to document this provenance.
API rate compliance: portfolIQ stays within the EDGAR 10 requests/second public limit and caches aggressively to avoid unnecessary load.
Fields provided
| Field | Source | Refresh cadence |
|---|---|---|
ticker | EDGAR company index | On filing event |
cik | EDGAR CIK lookup | Permanent identifier |
isin | EDGAR + ESMA FIRDS cross-reference | Static / corporate action |
name | EDGAR company name | On 8-K name change |
sector_gics | EDGAR SIC → GICS mapping | Quarterly |
exchange_mic | EDGAR filing exchange → MIC | On listing change |
market_cap_usd | EDGAR shares outstanding × price snapshot | Monthly snapshot |
Coverage: S&P 500 + Russell 2000 + approximately 8,500 companies filing with the SEC (all publicly listed US equities).
Refresh cadence
portfolIQ monitors three EDGAR filing categories:
- 10-K (annual report) — triggers a full refresh of all fundamental fields.
- 10-Q (quarterly report) — updates
market_cap_usdsnapshot and earnings-derived fields. - 8-K (current report) — triggers targeted refresh for name changes, exchange migrations, and material corporate actions.
Typical field staleness: 0–5 business days after a company files. The meta.computed_at timestamp in each response reflects the last ingestion run, not the filing date.
What is NOT provided in Phase 1
The following data points are not available via GET /v1/instruments/stock/{ticker} in v1.4.0:
| Data point | Reason | Roadmap |
|---|---|---|
| Price consensus (OHLCV) | Requires commercial licence (Tier 1 fusion Wave 2) | Sprint 31 |
| Fundamentals (P/E, D/E, revenue) | DJIM inputs — separate endpoint | Sprint 30 |
| Analyst consensus / estimates | No free redistributable source | Backlog |
| Non-US equities | Phase 1 = US only (SEC EDGAR scope) | Sprint 30–32 |
| Real-time intraday price | No free redistributable source | Backlog |
Non-US equities (EU, Asia, MENA) are not covered in Phase 1. Extension sprints target:
- UK: Companies House + LSE Delayed (Sprint 30)
- France: AMF info-financière + Euronext events (Sprint 30)
- Japan, Korea, Taiwan, Australia: EDINET / DART / TWSE / ASIC (Sprint 32)
Data quality indicator
Every response includes meta.data_quality:
| Value | Meaning |
|---|---|
"full" | All fields populated from primary source |
"partial" | Some fields missing (e.g. ISIN not cross-referenced yet) |
"stale" | Last refresh > 30 days ago (filing gap) |
If data_quality is "partial" or "stale", portfolIQ recommends treating the affected fields as indicative only.
Related pages
- Halal screening inputs — what ratios PIQ exposes and what it does not compute
- Multi-tier data sourcing — Tier 0 / Tier 1 / Tier 2 licensing framework
- Multi-source fusion — consensus price algorithm (VWAP, outlier detection, confidence score)
- Cross-asset correlations — rolling Pearson correlations using stock consensus series as input
- API reference — stocks — full endpoint schema and try-it-out
Not financial advice. Methodology disclosed. portfolIQ is not a registered investment advisor.