Skip to main content
GET
Get revenue signals by date

Authorizations

X-API-Key
string
header
required

Query Parameters

new
boolean
default:false

When true, restricts results to signals published in the current week.

revenue_signal_date_after
string<date>

Only return signals with a signal date on or after this date (YYYY-MM-DD, inclusive). Overrides new when both are given.

Example:

"2026-06-01"

revenue_signal_date_before
string<date>

Only return signals with a signal date on or before this date (YYYY-MM-DD, inclusive).

Example:

"2026-06-30"

limit
number

The number of results to return, default is 50.

page
number

The page number of results to return, base 0, default is 0.

Response

The list of revenue signals belonging to the requested list.

signal_id
string
required

Unique identifier for this revenue signal (prefixed with rev_).

Example:

"rev_288a8a7b4ea68bbfd674b035bde3659b"

signal_date
string<date>
required

The date (YYYY-MM-DD) the underlying observation was published (article or filing date).

Example:

"2025-12-16"

whats_new
string
required

Concise summary of what is new in this signal compared to the previous company context (e.g. "$40M ARR (2024); profitable; ...").

Example:

"Q2 rev $424K; net loss $10.8M; backlog ~$15M (+$11.2M YoY); shipped 8 WAM-V; partnerships with Mythos AI & Gradient Marine; AUVSI certification."

source_type
enum<string>
required

The kind of source the signal was derived from.

Available options:
news,
social,
public
Example:

"news"

source_url
string
required

URL to the source article or filing.

Example:

"https://www.roi-nj.com/2025/12/16/industry/energy-utilities/ocean-power-technologies-says-government-shutdown-hurt-earnings-revenue-in-quarter/"

source_article_id
integer
required

Internal article id for the source (only set for news / social).

Example:

496721

entity_id
string
required

Specter company id that this signal is attributed to. May be null if the company is referenced upstream but not tracked in our company DB.

Example:

"5e3bbfb900c8f4c966a2d566"

company_name
string
required

Name of the company the signal is attributed to.

Example:

"Ocean Power Technologies"

metric
enum<string>
required

Which revenue metric the value represents.

Available options:
ARR,
Revenue,
GMV
Example:

"Revenue"

annualized_usd
number
required

Annualised revenue in USD at the time of the signal.

Example:

1696000

year
integer
required

The fiscal year the revenue metric refers to.

Example:

2025

reference_date
string<date>
required

The date (YYYY-MM-DD) as of which the reported revenue figure is valid (e.g. EOY for a yearly figure, or a specific date for an ARR snapshot). May differ from signal_date.

Example:

"2025-06-30"

tags
string[]
required

Tags qualifying the revenue figure (e.g. PROJECTION when the figure is forecast rather than reported, or public for SEC-filing-derived figures).

Example:
context
string
required

The text excerpt the revenue figure was extracted from.

Example:

"Fiscal Q2 2025 revenue was $424K, down from $2.4M in the prior-year quarter; the company posted a net loss of $10.8M for the quarter; backlog was about $15.0M at Oct. 31."

traction
string
required

A short qualitative traction headline associated with the signal, if any.

Example:

"Net loss $10.8M in fiscal Q2 (vs. $3.9M prior-year), revenue $424,000 (down from $2.4M year-over-year), backlog ~$15.0M (up $11.2M, ~300% YoY), shipped 8 WAM-V autonomous surface vehicles, signed strategic partnerships with Mythos AI and Gradient Marine, AUVSI Trusted Uncrewed Maritime Systems Operator Training Provider certification."

is_profitable
boolean
required

Whether the company is reported as profitable at the time of the signal.

Example:

false

profitability_annual_usd
number
required

Annualised net income in USD at the time of the signal.

Example:

-43200000

profitability_year
integer
required

The fiscal year the profit figure refers to.

Example:

2025

profitability_reference_date
string<date>
required

The date (YYYY-MM-DD) as of which the reported profitability metric is valid.

Example:

"2025-06-30"

profitability_context
string
required

The text excerpt the profitability figure was extracted from.

Example:

"Posted a net loss of $10.8M for fiscal Q2 ended Oct. 31, 2025 (quarterly loss; annualized to -$43.2M)."

profitability_source_url
string
required

URL to the source backing the profitability claim.

Example:

"https://www.roi-nj.com/2025/12/16/industry/energy-utilities/ocean-power-technologies-says-government-shutdown-hurt-earnings-revenue-in-quarter/"

profitability_source_article_id
integer
required

Internal article id for the profitability source (only set for news / social).

Example:

496721