greeksoup/ docs
Setup

Data sources

The source is named on every screen. This is the same list in one place, with what each one feeds.

Free, no key

  • SEC EDGAR. Form 4 insider filings on your names, the 13F filings of every fund you follow with what changed since the last one, and 13D and 13G activist filings. The SEC asks for a contact e-mail with each request, which you set once in Settings.
  • FINRA. Short interest, twice a month, and the daily short-volume ratio, kept on separate lines on purpose.
  • CBOE. Delayed option chains on every US name on your desk: put/call, the walls, the paid-for move, unusual strikes and open-interest builds.
  • FRED. Twenty-two macro series in groups, and the long monthly history of commodity benchmarks that have no exchange contract.
  • The Senate and the House. Trading disclosures on your names and on the members you follow; the House reports arrive as PDFs and the desk reads them.
  • Yahoo Finance. Quotes, candles and the ticker page basics for any listing, and the exchange-traded commodity contracts on the board. Near live for US listings, fifteen to twenty minutes delayed for most other exchanges. Yahoo's quote endpoints are unofficial and can change; when they do, the desk falls back to the last saved quote and says so.
  • Nasdaq. The earnings date and the dividend record of each US name on the Calendar, and the US market pulse on Desk · Home: every large and mega cap with today's move, volume and sector, from which the gainers, the losers, the most active by dollars traded and the sector snapshot are read.
  • Frankfurter. The daily reference exchange rates that central banks publish (the ECB's among them), keyless and open source, for the history behind the five currency cards on the Commodities board and their level when the free quote feed does not answer. One fixing a day, so the level is the last business day's.
  • OpenFIGI. Bloomberg's open identifier service, keyless. When what you type into a search box on Desk · Book or a watchlist is an ISIN, the twelve-character code on every broker statement, the listings that carry it come from here, the issuer's home exchange first, each checked against the free feed before it is shown. Asked once per ISIN and kept.
  • The BLS, the Fed and Forex Factory. The economic calendar when the free feed's own calendar refuses the address, which it does for days at a time: the Bureau of Labor Statistics' release schedule (this month and the next two, every print with its time), the Federal Reserve's FOMC meeting calendar (the statement at two in the afternoon Eastern on the last day), and Forex Factory's public weekly file for this week's prints across the nine major currencies with the forecast and the previous. All three keyless.
  • Trading Economics. One dated sentence per page for the commodity benchmarks with no contract and no FRED series, for the current level and the day, month and year change.
  • The home market's own sources. The exchange's filings and results calendar, and the statistics office, for the market your broker trades in. India and the United States ship. For India the Commodities board also reads the Indian Mandi Prices API (agmarknet's daily mandi arrivals for five states, keyless, the benchmark market's modal price per crop) and the Rubber Board of India's daily sheet.

With a key

  • Your broker. Holdings and cash always; live ticks, futures, margin, chains and a symbol master where the broker serves them. Fifteen ship. Brokers.
  • Your data provider. The parsed financials, estimates, peers and the rest. Data providers.
  • Your AI. Your AI.

How a source failing shows up

A failed fetch never blanks a screen. The last good value stays, with its date, and the screen says the source is stale. Scrapes are date-stamped for the same reason.