Developers
The hedg3 data API.
Programmatic access to the public-record market datasets behind hedg3 — insider transactions, institutional holdings, congressional trading disclosures, lobbying, federal contracts, short data and the economic calendar. One REST surface, one key, documented limits.
8 datasets · 7 endpoint groups · 120 requests/minute
Quickstart
One header, one versioned path.
Every request carries your key as a bearer token. Keys are prefixed so a leaked one is identifiable on sight, and the plaintext value is shown exactly once when it is created.
curl -H "Authorization: Bearer hg3_live_..." \
"https://api.hedg3.ai/v1/data/congress?symbol=NVDA&limit=50"Bearer authentication
Prefixed, hashed keys sent in an Authorization header — never a query string.
Rate-limit headers
Limit, remaining and reset on every response; Retry-After on a 429.
Structured errors
RFC 7807 problem details on every error, each carrying a request id.
Immediate revocation
Rotate or revoke a key at any time. Per-key last-used and call counts.
Catalogue
What you can query.
Every dataset below is sourced from public regulatory filings or official government publications, normalized into one consistent schema and served with cursor pagination.
Congress
/data/congress
Congressional trading disclosures
Reported transactions by sitting members. House coverage today — see the note below.
Insiders
/data/insiders
Insider transactions
Buys and sells by officers, directors and 10% owners, from public regulatory filings.
Institutions
/data/institutions
Institutional holdings
Quarter-end positions disclosed by large asset managers, with full history retained.
Short data
/data/shorts/{symbol}
Short interest
Reported open short positions, published on a twice-monthly cycle.
Government
/data/lobbying · /data/contracts
Lobbying disclosures
Federal lobbying registrations and reports by client and firm.
Federal contract awards
Government contract awards by agency and contractor.
Offerings
/data/ipos
IPO calendar
Companies that have filed to go public, with pricing status.
Economy
/data/economy/calendar
Economic calendar
Scheduled macro releases and central-bank events from official government sources.
Coverage note
Congressional trading disclosures currently cover the House only. Senate coverage is in progress and is not included today. We would rather state the gap than let you discover it in production.
Pricing
Priced on daily volume and history.
API access is sold separately from a hedg3 subscription and is not included with the free plan.
Switch to annual to save about two months
Trial
Evaluate the full Layer A catalogue before you commit.
- All 8 public-record datasets
- 120 requests per minute
- 15,000 requests per day
- 7-day historical lookback
- Cursor pagination on every endpoint
- Personal use
Basic
For a single application or research workflow.
- All 8 public-record datasets
- 120 requests per minute
- 20,000 requests per day
- 30-day historical lookback
- Cursor pagination on every endpoint
- Personal use
Advanced
Higher throughput and the deepest history we publish.
- All 8 public-record datasets
- 120 requests per minute
- 50,000 requests per day
- 90-day historical lookback
- Cursor pagination on every endpoint
- Personal use
Custom
Volume beyond Advanced, or terms your team needs in writing.
- All 8 public-record datasets
- Negotiated rate and daily volume
- Negotiated historical lookback
- Terms in writing
Every tier
120 requests per minute — including the trial.
A burst limit protects the platform, so it does not change with what you pay. The daily cap is the lever that does.
Coming next
Streaming over websockets.
REST covers the catalogue today. A websocket channel for push-based updates is planned as a later phase on the Advanced tier. It is not available yet, and nothing on this page depends on it shipping.
Start with the trial.
Pick a tier and mint your first key from your account settings — no sales call required. Volume beyond the Advanced tier, or terms you need in writing, is where we'd rather talk first.
Before your first key is issued you'll accept the market-data subscriber agreements, which confirm you are a non-professional subscriber. It takes a moment and applies to your whole account.
Backwards-looking disclosures carry statutory reporting delays (institutional holdings up to 45 days; insider transactions ~2 days; congressional trades up to 45 days). Data is served as reported by the originating public source.
API access is licensed for use within your own application and may not be redistributed or resold. hedg3 is not a broker-dealer. The API returns general, non-personalized market data — not investment advice. See Disclosures for sourcing, latency, and limitations.