HedgeFriend
v0.2

Alternative data, served as REST.

Clean APIs for SEC filings, XBRL financials, futures positioning, FEMA disasters, attention metrics, federal regulations, congressional trades, WARN Act layoffs, hiring velocity, GitHub activity, and macro indicators. Built for quants, indie traders, and AI agents. No enterprise contracts.

curl
bash
# register, get your key
curl -s -X POST api.hedgefriend.dev/v1/auth/register \
  -H 'content-type: application/json' \
  -d '{"email":"you@example.com"}'

# 30-day Wikipedia attention for $NVDA
curl -s \
  -H "Authorization: Bearer $HF_KEY" \
  'api.hedgefriend.dev/v1/alt/wiki/NVDA?days=30' | jq
SEC EDGARXBRL FinancialsForm 4 InsidersForm 144 Sales8-K Items13-F Holdings13D/G StakesLate FilingsFails-to-DeliverCFTC COTARK TradesMad Money PicksFEMA DisastersWikipedia AttentionFederal RegisterSTOCK ActLobbying (LDA)WARN Act LayoffsHiring VelocityGitHub ActivitySubdomain DiscoveryRail CarloadsTSA ThroughputFRED MacroCBOE VIX SurfaceUS CensusNews SentimentSEC EDGARXBRL FinancialsForm 4 InsidersForm 144 Sales8-K Items13-F Holdings13D/G StakesLate FilingsFails-to-DeliverCFTC COTARK TradesMad Money PicksFEMA DisastersWikipedia AttentionFederal RegisterSTOCK ActLobbying (LDA)WARN Act LayoffsHiring VelocityGitHub ActivitySubdomain DiscoveryRail CarloadsTSA ThroughputFRED MacroCBOE VIX SurfaceUS CensusNews Sentiment
Why HedgeFriend

The signals quants actually use, not another OHLCV proxy.

Most retail finance APIs reshuffle the same price feed. HedgeFriend is built around the alternative data that academic literature has repeatedly shown to be predictive — and that public agencies already publish for free.

Primary sources only

SEC EDGAR, CFTC, FEMA, FRED, the Federal Register, state WARN registries. We don't scrape — we pull from the agency.

One auth, one shape

A single bearer token. Consistent JSON envelopes. Predictable pagination. No SOAP, no XBRL parsing on your side.

For AI agents

Agent-ready alternative data, for indie traders.

Plug HedgeFriend into Claude Desktop, Cursor, or Claude Code with one config block. Your agent can reach every endpoint — SEC filings, insider trades, congressional disclosures, lobbying, layoffs, hiring, macro, and news sentiment — and finds the right one by asking. No glue code, no schemas to memorize.

claude_desktop_config.json
json
{
  "mcpServers": {
    "hedgefriend": {
      "url": "https://mcp.hedgefriend.dev/mcp/",
      "headers": {
        "Authorization": "Bearer hf_..."
      }
    }
  }
}
Data sources

All the feeds. One key.

See all data sources →
SECDaily

SEC Filings

10-K, 10-Q, 8-K and other filings — type, date, period of report, and direct document URL.

GET/v1/sec/filings/{symbol}
SECDaily

Insider Trades

Form 4 transactions: who at the company bought or sold, share count, price, transaction code.

GET/v1/sec/insider-trades/{symbol}
SECQuarterly

Institutional Holdings

13-F filings: fund name, position size, market value, period.

GET/v1/sec/institutional/{symbol}
SECDaily

Schedule 13D / 13G Filings

Every SCHEDULE 13D and SCHEDULE 13G beneficial-ownership filing across all US issuers — subject company, filer names, filing type, filed date, and link to the primary document.

GET/v1/sec/13d
SECDaily

8-K Item Taxonomy

Every Form 8-K broken out by the numbered items it discloses — restatements (4.02), auditor changes (4.01), officer departures (5.02), cybersecurity incidents (1.05), material impairments (2.06), shareholder vote results (5.07), bankruptcy, delisting notices and the rest — with the official caption and a link to the filing.

GET/v1/sec/8k-items
SECDaily

Late-Filing Notifications

Form 12b-25 notifications across all US issuers — filed when a company cannot deliver its 10-K or 10-Q on time. Each row tracks whether the overdue report ever arrived, how many days it took, and whether the extension window lapsed without it.

GET/v1/sec/late-filings
AlternativeTwice monthly

Fails-to-Deliver

Shares that failed to settle — trades where the seller never delivered — for every security with an open fail balance, published twice a month with the settlement-date price.

GET/v1/market/fails-to-deliver
SECDaily

Form 144 Proposed Sales

Notices of proposed sale filed by corporate insiders selling restricted or control stock. Each row carries the intended share count and dollar value, the share of the company it represents, the seller's stated timing, the broker, and how the shares were originally acquired.

GET/v1/sec/form-144
SECDaily

Reg-A+ Offerings

Form 1-A and amendments — issuer, CIK, offering amount, primary document URL.

GET/v1/sec/reg-a
Predictable shapes

JSON that behaves the same on every endpoint.

Every list endpoint returns the same envelope: a data array, a meta block with pagination, and an X-RateLimit-* header on every response. Errors come back as { error, code }. That's it.

  • Bearer token auth — no signing, no OAuth dance.
  • ISO-8601 dates. UTC always. Decimal numbers as numbers.
  • Rate limits surfaced via headers. No quota guessing.
GET /v1/sec/insider-trades/NVDA
json
{
  "data": [
    {
      "filing_date": "2026-04-21",
      "reporter": "Huang, Jen-Hsun",
      "role": "CEO, 10% Owner",
      "transaction_code": "S",
      "shares": 120000,
      "price": 982.41,
      "value_usd": 117889200
    }
  ],
  "meta": {
    "count": 1,
    "next": "cursor:eyJpZCI6..."
  }
}

Build with the same data the funds use.

Free tier is live. Grab a key and start hitting the API.

Get a free API key