DeltaSignal Radar - Connector API Docs

Version: v1 (live). Product: DeltaSignal Radar - SEC filing signals in plain English.

The API service at the base URL below is live and serving real data. The endpoints below document the v1 contract.

Base URL

https://deltasignal-radar-531691677642.us-central1.run.app

Base URL for all v1 API paths is the base URL above plus /v1.

Authentication

OAuth 2.0 with PKCE. GET {base}/connect starts the flow: the user approves, the code is exchanged for an access token plus a rotating refresh token, scoped to watchlist read/write and signals read.

All API calls use a Bearer token:

Authorization: Bearer <access_token>

Rate limit: 60 requests per minute per token (v1).

Endpoints

1. GET /v1/filings/recent

Recent filings for your tickers.

Params (query): tickers comma-separated tickers, e.g. tickers=NVDA,TSLA; forms comma-separated form types, e.g. forms=8-K,13D; since ISO 8601 timestamp lower bound, e.g. since=2026-09-22T00:00:00Z.

Returns: ticker, form, filed_at, accession, title, edgar_url, signal_tier.

2. GET /v1/filings/{accession}/summary

Plain-English summary of one filing.

Path param: accession, EDGAR accession number (dashes optional).

Returns: what the filing is, why it matters, key facts, and the EDGAR accession link.

3. GET /v1/watchlist

List the user's tickers. Auth required.

4. POST /v1/watchlist

Add a ticker. Auth required.

Body (JSON): {"ticker": "..."}

5. DELETE /v1/watchlist/{ticker}

Remove a ticker. Auth required.

Path param: ticker, ticker symbol, e.g. TSLA.

6. GET /v1/scoreboard

Public hit/miss record: pattern, call, outcome, filed_at.

Params (query): window, 7d or 30d (default 7d).

No auth required: this is the public scoreboard.

Utility

GET /health        liveness check
GET /openapi.json  OpenAPI 3.1 spec

Data touched

Public SEC EDGAR filings (public domain).
Per user: watchlist tickers, alert preferences, tier status, email.
We never touch the user's brokerage, portfolio, or any financial account.

No-advice disclaimer

DeltaSignal Radar provides analytical validation only: filing patterns plus evidence. Nothing in any signal is investment advice. Do not act on signals as if they were recommendations to buy, sell, or hold any security.

Support

Support contact: to be confirmed.