Quick Usage Guide

Default Behavior

Pinging the API with no parameters will hit our Firehose endpoint, returning the latest available data.

Filtering by Time Frame

To filter news from specific time frames, use the datetime_start and datetime_end parameters in ISO 8601 format:

Format: YYYY-MM-DDTHH:MM:SSZ

Example:

• datetime_start=2024-01-15T00:00:00Z
• datetime_end=2024-01-15T23:59:59Z

Note: Times are in UTC (indicated by the Z suffix).

Filtering by Sources, Tags, and Collections

Use our News Reference Data endpoint to get the complete list of available Sources, Tags, and Collections.

Example 1: Pull news directly from exchanges about token delistings:

• collection_uids=source_group_cp2xu (Direct from Exchanges)
• tag_uids=tag_subgroup_e125h (Events > Delisting)

Example 2: Pull SEC filings for Grayscale Investments:

• collection_uids=source_group_j5usl (SEC Filings)
• tag_uids=tag_evq4n (Grayscale Investments)