Skip to content
Back to search

factor-data

Factor Data — ooooOasis

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 21 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/oooooasis-fds/factor-data with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/oooooasis-fds/factor-data'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/oooooasis-fds--factor-data/badge.svg)](/listings/oooooasis-fds--factor-data)

HTML

<a href="/listings/oooooasis-fds--factor-data"><img src="/api/listings/oooooasis-fds--factor-data/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 150 lines
  1. # Factor Data — ooooOasis
  2. Point-in-time factor data for North American equities, served as a REST API and as an MCP server. The universe covers 583 tickers (US and Canadian listings); 180 factors are registered, 83 of them with computed history — 724,421 factor values as of the latest snapshot, plus SEC company facts (2.66M rows), an SEC filings index, earnings calendars and option-chain snapshots. Every factor value is point-in-time: it carries both the date it describes and the moment it became available (`available_at`), so backtests never see information from the future.
  3. Product page: https://www.oooooasis.com/fct · Pricing: https://api.oooooasis.com/pricing
  4. ## Get an API key
  5. Keys are per service — a Factor Data key (prefix `ffds_live_`) works only on this service.
  6. 1. Register at https://api.oooooasis.com/register — choose the Factor Data service and enter your email.
  7. 2. Click the verification link we email you (valid 24 hours). Your key is shown **once** on that page — store it immediately.
  8. 3. Lost your key? Re-issue it at https://api.oooooasis.com/reissue — after email verification the old key is revoked and a new one is shown once.
  9. The free tier is live: **100 calls/day**, no card required. Free keys expire 90 days after issue (register again to renew). Paid tiers are **not on sale yet** — see "Limits & errors" for exactly what a free key can call, and join the waitlist by emailing fct-data@oooooasis.com.
  10. Send your key on every call in the `Authorization` header:
  11. ```
  12. Authorization: Bearer <your key>
  13. ```
  14. Keys in URLs (`?api_key=...`) are rejected with a 400 error.
  15. ## REST API
  16. Base URL: `https://api.oooooasis.com/fct` — read-only, GET only (other methods answer 405).
  17. Data responses share one shape: `{"query": ..., "rows": N, "values": [...]}`. Factor rows include `date`, `available_at`, and a read-time quality `state` (`fresh` / `stale`) evaluated at `state_as_of`. Missing data is missing — nothing is zero-filled or backfilled.
  18. | Method | Path | Access | Key parameters | Returns |
  19. |---|---|---|---|---|
  20. | GET | `/health` | Public | — | Service status (no key, not metered) |
  21. | GET | `/meta` | Public | — | Table row counts, latest data dates, universe coverage (no key, not metered) |
  22. | GET | `/asof` | **Free** | `ticker`*, `factor`*, `as_of`*, `date` | Point-in-time value(s) of one factor for one ticker: rows with `available_at ≤ as_of`; add `date` for a single date's then-visible value |
  23. | GET | `/history` | Paid | `ticker`*, `factor`*, `start`, `end`, `as_of` | Time series for one ticker × factor |
  24. | GET | `/cross_section` | Paid | `date`*, `factor`, `as_of` | One factor (or all factors) across all tickers on one date |
  25. | GET | `/registry` | Paid | `factor` | Factor registry metadata (definition, status, source); omit `factor` for the whole registry (≤1,000 entries per call) |
  26. | GET | `/px` | Paid | `symbol`*, `start`*, `end`*, `as_of` | Price history rows for one symbol |
  27. | GET | `/bars` | Paid | `symbol`*, `start`*, `end`*, `as_of` | Daily bars for one symbol |
  28. | GET | `/calendar` | Paid | `ticker`*, `as_of`*, `date` | Earnings / ex-dividend calendar for one ticker, as known at `as_of` |
  29. | GET | `/calendar/crosscheck` | Paid | `ticker`*, `as_of`* | Earnings-calendar cross-check rows for one ticker |
  30. | GET | `/regime` | Paid | `date` or `start`+`end`, `as_of` | Market-regime series |
  31. | GET | `/markets` | Paid | `date` or `start`+`end`, `as_of` | Seven-markets index series |
  32. | GET | `/universe` | Paid | `date` or `ticker`, `as_of` | Universe membership rows |
  33. | GET | `/chain` | Paid | `symbol`*, `date`*, `expiry`, `right` (`call`\|`put`), `as_of` | Option-chain snapshot rows |
  34. | GET | `/iv` | Paid | `ticker`*, `start`*, `end`*, `as_of` | Implied-volatility history for one ticker |
  35. | GET | `/iv/term` | Paid | `ticker`*, `date`*, `expiry`, `as_of` | IV term-structure rows |
  36. | GET | `/iv/census` | Paid | `ticker`*, `as_of` | IV census rows for one ticker |
  37. | GET | `/iv/overlap` | Paid | `date`*, `as_of` | IV overlap-check rows for one date |
  38. | GET | `/sec/facts` | Paid | `ticker`*, `concept`, `start`, `end`, `fy`, `fp`, `as_of` | SEC company-facts (XBRL) values; `fy`/`fp` optional, default latest filed |
  39. | GET | `/sec/filings` | Paid | `ticker` or `accession`, `form`, `start`, `end`, `as_of` | SEC filings index rows |
  40. \* = required. **Free** = callable on the free tier (scope below). **Paid** = requires a paid tier; paid tiers are not on sale yet, so free keys receive `403 tier_not_entitled` on these today.
  41. ### Free-tier scope
  42. A free key can call `/asof` only (plus the public `/health` and `/meta`), within this scope:
  43. - Tickers: the S&P 500 Top 100 by market cap (monthly list).
  44. - Factors: the 37 recognized free-tier factors.
  45. - One ticker × one factor per call.
  46. - Known exception: 252-day IV Rank (`iv_rank`) is **not available yet** — the IV sequence started 2026-11-04 and needs 252 trading days (earliest ~2027-11). Requests for it answer `403 factor_not_available` with that reason. The realized-volatility percentile (`rv_pctile_6mo`) is a different measure and is never substituted for it.
  47. ### Examples
  48. Service metadata — public, no key:
  49. ```bash
  50. curl "https://api.oooooasis.com/fct/meta"
  51. ```
  52. Current factor value — the free-tier call:
  53. ```bash
  54. curl -H "Authorization: Bearer $KEY" \
  55. "https://api.oooooasis.com/fct/asof?ticker=AAPL&factor=rsi14&as_of=2026-11-20"
  56. ```
  57. Factor history (paid tiers, not yet on sale):
  58. ```bash
  59. curl -H "Authorization: Bearer $KEY" \
  60. "https://api.oooooasis.com/fct/history?ticker=AAPL&factor=rsi14&start=2026-10-01&end=2026-11-19"
  61. ```
  62. ## MCP server
  63. URL: `https://mcp.oooooasis.com/fct/mcp` — Model Context Protocol (protocol version 2024-11-05), Streamable HTTP (`POST` to this URL). Every request needs your Factor Data key in the `Authorization: Bearer` header; the key selects this service. The same quota, tier scope and coverage metering as REST apply to tool calls.
  64. Generic client configuration:
  65. ```json
  66. {
  67. "mcpServers": {
  68. "factor-data": {
  69. "url": "https://mcp.oooooasis.com/fct/mcp",
  70. "headers": { "Authorization": "Bearer <your factor key>" }
  71. }
  72. }
  73. }
  74. ```
  75. `tools/list` only shows the tools your key can currently call. 14 tools are registered; while paid tiers are not on sale, only the two marked **Available now** are listed and callable — the rest appear when paid access opens.
  76. | Tool | Available | Parameters | Purpose |
  77. |---|---|---|---|
  78. | `factor_asof` | **Available now** (free) | `ticker`*, `factor`*, `as_of`* | Current value of one factor for one ticker (free-tier scope: Top-100 ticker × one of the 37 recognized factors) |
  79. | `factor_meta` | **Available now** (not metered) | — | Service metadata: snapshot time, row counts |
  80. | `factor_history` | Paid | `ticker`, `factor`, `from`, `to` | Factor history for one ticker × factor |
  81. | `factor_cross_section` | Paid | `factor`, `as_of`, `limit` | Cross-section of one factor on one date |
  82. | `factor_registry` | Paid | `factor`, `limit` | Factor registry lookup |
  83. | `factor_px` | Paid | `ticker`, `from`, `to` | Market prices for one ticker |
  84. | `factor_bars` | Paid | `ticker`, `from`, `to` | Market bars for one ticker |
  85. | `factor_calendar` | Paid | `from`, `to` | Trading calendar |
  86. | `factor_regime` | Paid | `ticker`, `from`, `to` | Market regime for one ticker |
  87. | `factor_markets` | Paid | — | Market list |
  88. | `factor_universe` | Paid | `as_of`, `limit` | Universe list |
  89. | `factor_chain` | Paid | `ticker` | Option-chain lookup for one ticker |
  90. | `factor_iv` | Paid | `ticker` | Implied volatility for one ticker |
  91. | `factor_sec` | Paid | `ticker`, `form`, `from`, `to` | SEC filings for one ticker |
  92. ## Limits & errors
  93. - **Daily quota (free):** 100 calls/day across the entitled endpoints. Responses carry `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset` (epoch seconds; quota resets at midnight US/Eastern).
  94. - **Coverage metering:** distinct (ticker × factor) pairs you touch are counted over a rolling 30-day window; the free-tier cap is 300 pairs. At 80% you get an `X-Coverage-Warning: 80%` header; over the cap, calls answer `429 coverage_exceeded` (pairs roll out of the window daily — there is no fixed reset day).
  95. - **Response caps:** `/history` and `/cross_section` return at most 10,000 rows per call; `/chain` 10,000 rows; `/sec/facts` and `/sec/filings` 1,000 rows; `/px`, `/bars`, `/regime`, `/markets` date ranges are limited to 366 days. Over a cap the API answers 400 — it never silently truncates.
  96. - **Errors** are always JSON: `{"error": {"code": ..., "message": ...}}`. Codes you may see:
  97. - `400 key_in_url_rejected` — key sent in the URL; use the `Authorization` header.
  98. - `400 upstream_error` — bad or missing parameters, or an over-cap request (the message says which).
  99. - `401 unauthorized` — missing, invalid, revoked or expired key.
  100. - `403 tier_not_entitled` — your tier may not call that endpoint group.
  101. - `403 factor_not_available` — the factor is known-unavailable (e.g. 252-day IV Rank, above).
  102. - `404 not_found` — unknown path.
  103. - `429 quota_exceeded` — daily quota used up; the body carries `limit`, `used` and `resets_at`, and the response carries a `Retry-After` header.
  104. - `429 coverage_exceeded` — rolling 30-day coverage cap reached; the body carries `limit` and `used_30d`.
  105. ## Data notes
  106. - **Point-in-time by construction.** Factor values are stored as revisions with `available_at` timestamps; as-of queries return the highest revision that was available at the requested moment, and every response is reverse-checked so no row with `available_at > as_of` can leak through. Restatements appear as new revisions — history is never silently rewritten.
  107. - **Freshness.** The factor history is updated on trading days; `/fct/meta` always reports the current latest date per table (factor history latest: 2026-11-19 at the time of writing). Price history (`px_history_daily`) can lag the factor panel by a few days (latest: 2026-11-16 at the time of writing) — check `/meta` for live values rather than assuming.
  108. - **Coverage.** 583 tickers have factor history (83 factors); the registry lists 180 factors, including registered-but-not-yet-computed ones — a registry entry is a definition, not a promise of data. Free-tier scope (Top 100 × 37 factors) is narrower than the full panel by design.
  109. ## Links & contact
  110. - Product page: https://www.oooooasis.com/fct
  111. - MCP Yellow Page listing: https://mcpyp.com/mcp/com.oooooasis/factor-data
  112. - Pricing & paid-tier waitlist: https://api.oooooasis.com/pricing
  113. - Sister service — TSX Data (Canadian market data): https://github.com/ooooOasis-fds/tsx-data · https://www.oooooasis.com/tsx
  114. - Contact: fct-data@oooooasis.com

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.