Market-Wide Gap Search, Self-Service Account Endpoints & Sharper Cost Estimates

New: Cross-Ticker Gap-Stats Search

GET /v1/gap-stats-advanced runs the same daily gap-stats dataset as /v1/gap-stats, but lets you sweep the whole market for a given gap shape and layer numeric range filters on top. ticker is optional here — omit it to scan all names, or supply one to subset to a single ticker. Ordered by date descending.

Parameters (all optional)

ticker — symbol; omit to search across all tickers.
date_from / date_to — inclusive date range.
min_gap_percentage / max_gap_percentage — gap % bounds (may be negative).
closed_over_vwap — filter by whether the stock closed above its VWAP.
min_premarket_dollar_volume / max_premarket_dollar_volume
min_premarket_volume / max_premarket_volume
min_volume / max_volume
min_dollar_volume / max_dollar_volume
min_market_cap / max_market_cap
page, limit — pagination (defaults: 1, 10; max limit 100).

Each row returns the same shape as /v1/gap-stats: ticker, date, market open, previous-day close, gap %, intraday high/low (with timestamps), market close, closed-over-VWAP flag, premarket VWAP, premarket volume and dollar volume, regular-session volume and dollar volume, market cap, after-hours close, plus associated SEC filing types and AskEdgar catalyst tags.

New: Account, Usage & Pricing Endpoints

Five self-service endpoints let you inspect your own account, spend, and pricing directly from the API. All are authenticated with your API-KEY header and are free to call (non-billable).

GET /v1/overview — your organization name, tier, and the list of data endpoints your key is licensed to call. Use it as a discovery probe before building a workflow.
GET /v1/balance — your current account credit balance in dollars. Poll it before a large batch, or wire it into low-balance alerting.
GET /v1/usage — aggregate usage over a date range (request count, records returned, bytes served, dollar cost) plus a per-day breakdown. Defaults to the last 30 days. Supports start_date, end_date, page, limit.
GET /v1/usage/activity — paginated, request-by-request activity log: timestamp, endpoint, which key made the call, status code, records returned, response/billed bytes, latency, and cost. Filterable by endpoint; defaults to the last 30 days.
GET /v1/pricing — per-endpoint pricing snapshot (per-GB and per-MB price) for the endpoints your tier can access.

Updated: After-Hours and Premarket session-volume

/v1/afterhours-stats and /v1/premarket-stats now return a share-count volume field for the session:

afterhours_volume — total shares traded during the after-hours session (on /v1/afterhours-stats).
premarket_volume — total shares traded during the premarket session (on /v1/premarket-stats).

Existing fields are unchanged; the new field is additive.

Updated: More Accurate Cost Estimates (`/estimate`)

/estimate now honors the limit parameter. Previously it was ignored, so estimates could project far more records than a real, paginated call returns. Pass the same limit you intend to use and the estimate is capped to one page.

Updated: Clearer Usage & Billing Reporting

The usage/activity data now distinguishes: