API Documentation

Authentication

Every endpoint accepts a bearer token in the Authorization header. Create a free account, then upgrade to Signal Analyst to generate a key from the Account page.

Authorization: Bearer f55_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Keys are shown once at generation time — store them somewhere safe. Regenerating a key immediately invalidates the old one. You can also browse any endpoint in a logged-in browser session without a key (session cookie auth) — useful for quick checks, not for scripts.

Rate Limits

Plan	Requests / day
Signal Analyst	500
Research	500
Pro	2000
Institutional	10000

Limits reset at midnight UTC. Exceeding your limit returns 429.

Signal Leaderboard

GET/api/signals

Current Confluence Score leaderboard — one row per company, latest signal date.

Param	Type	Default	Description
min_score	int	40	Minimum Confluence Score to include (1–100)
exchange	str	(all)	`TSX` or `TSXV`
format	str	json	`json` or `csv`

# Example curl -H "Authorization: Bearer f55_xxxx" \ "https://www.form55.ca/api/signals?min_score=75&exchange=TSX"

{ "count": 2, "signals": [ { "ticker": "AEM", "issuer_name": "Agnico Eagle Mines Limited", "exchange": "TSX", "sector": "Mining", "signal_date": "2026-07-01", "signal_score": 89, "insider_buys_90d": 3, "unique_buyers_90d": 1, "insider_buy_value_90d": 1200000.0, "lobbying_contacts_90d": 7, "contract_wins_90d": 0, "is_confluence": true }, "…" ] }

GET/api/scores/<ticker>

Score history for a single company (up to 200 most recent snapshots).

Param	Type	Default	Description
format	str	json	`json` or `csv`

# Example curl -H "Authorization: Bearer f55_xxxx" \ "https://www.form55.ca/api/scores/AEM"

{ "ticker": "AEM", "issuer_name": "Agnico Eagle Mines Limited", "exchange": "TSX", "count": 42, "signals": [ { "signal_date": "2026-07-01", "signal_score": 89, "insider_buys_90d": 3, "unique_buyers_90d": 1, "insider_buy_value_90d": 1200000.0, "lobbying_contacts_90d": 7, "contract_wins_90d": 0, "is_confluence": true }, "…" ] }

Errors

Status	Meaning
401	Missing, invalid, or revoked API key
403	Key is valid but the plan doesn't include API access (Signal Analyst+ required)
404	Ticker not found
429	Daily rate limit exceeded for your plan

Not investment advice. Scores are derived entirely from public Canadian regulatory filings.