GateData.AI

Canonical event search

Query market and macro events.

GET/api/v1/events
Domain
Events, News, Sentiment & Signals
Level
Aggregated event
MCP tool
events_news_query (task=event_search)

Available data

Returns
Market and macro events
Market coverage
Crypto and US equities
Query granularity
Each query returns a list of events; filter by ticker, keyword, or time. One event may mention several assets and is not split by source

Authentication

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Query Parameters

event_idstringqueryoptional

Aggregated event id.

asset_idstringqueryExampleasset_btcoptional

Object filter (one of asset_id / ticker+market required).

listing_idsstring[]queryExamplelisting_nvda_xnasoptional

Listing identifiers (e.g. listing_nvda_xnas).

querystringqueryExampleNVDAoptional

Search text used to identify the object you want.

tickerstringqueryExampleAAPLoptional

Ticker when used with market.

marketMarketqueryExampleus_equityoptional

us_equity | hk_equity | kr_equity | uk_equity | jp_equity | crypto

fromdatetimequeryExample2026-07-01T00:00:00Zoptional

Start time (ISO 8601).

todatetimequeryExample2026-07-31T23:59:59Zoptional

End time (ISO 8601 UTC).

detailbooleanqueryExamplefalseoptional

When true, include event_content, source_count, primary_global_content_id, global_content_ids, first_published_at, and last_updated_at (default false).

limitintegerqueryExample20optional

Max rows to return (up to 1000).

Response

dataobject
events[]object[]

Aggregated events (event_id, title, summary, market, event_category, impact_direction, importance_level, …); detail=true adds event_content, source_count, primary_global_content_id, global_content_ids, first_published_at, last_updated_at

event_idstringExampleevt_fe3d2766e277c807369e831d

Aggregated event id

titlestringExampleother

Title / category label as returned

summarystringExampleVitalik Buterin 在推文中表示，以太坊未来可能同时采用 UTXO …

Event summary

marketMarketExamplecrypto

Primary market (e.g. crypto)

event_categorystringExampletechnology

Event category

impact_directionstringExampleneutral

Impact direction

importance_levelstringExamplemedium

Importance level

chain[]string[]ExampleBitcoin

Chains tagged on the event

industry[]string[]

Industry tags

sector[]string[]Exampleinfrastructure

Sector tags

asset_ids[]string[]Exampleasset_btc

Linked asset ids

entity_ids[]string[]

Linked entity ids

instrument_ids[]string[]

Linked instrument ids

listing_ids[]string[]

Linked listing ids

institution_codes[]string[]

Institution codes when tagged

macro_indicator_codes[]string[]

Macro indicator codes when tagged

mentions[]string[]ExampleUtreexo

Optional ticker / name mentions extracted from the event

data_statusDataStatusExampleok

ok / partial / no_data

empty_reasonstring | null

Empty / partial reason code

errorobject | null

Error object; null on success

external_refs[]object[]

External, lineage, and upstream source references

lineage_refs[]object[]

External, lineage, and upstream source references

source_refs[]object[]

External, lineage, and upstream source references

metadataobject

Response status and resolution information

entitlementsobject

Endpoint and field / resolution / evidence entitlement levels

endpointstringExampleevents

Entitled endpoint id (e.g. signals.sentiment)

evidence_fanout_levelstringExamplecustom

Evidence fan-out entitlement level

field_levelstringExamplecustom

Field-level entitlement

object_resolution_levelstringExampleL3

Object-resolution entitlement (e.g. L3)

data_statusDataStatusExampleok

Mirror of readiness in metadata

resolution_statusResolutionStatusExampleresolved

Resolver status and pinned ticker / market when present

resolved_tickerstringExampleBTC

Resolver status and pinned ticker / market when present

resolved_marketstringExamplecrypto

Resolver status and pinned ticker / market when present

limitations[]string[]

Known data limitations

updated_atdatetime | stringExample2026-08-17T08:25:18Z

Most recent object or response update time

object_refs[]object[]

Unified object references

typeObjectRefTypeExampleasset

Object reference type

idstringExampleasset_btc

Canonical object identifier

entity_idstringExampleentity_rd_2

Canonical entity identifier

asset_idstringExampleasset_btc

Canonical asset identifier

resolved_fromstringExampleprimary_asset

Input used to resolve the object

resolution_confidencestringExample1

Object resolution confidence

Errors & fallback

200
assets_resolve name multi-match; confirm from data[] candidates.
200
The object resolved but no data is available; empty_reason may be not_covered_by_source, unsupported_metric, or limited_depth.
400
Invalid parameters or an ambiguous market listing; ambiguity responses include required_params + candidates.
401
The API key is missing or invalid.
403
The current key scope or plan cannot access this data domain.
404
The requested resource does not exist; source coverage gaps are not 404 responses.
402
Credits or monthly quota exhausted.
429
Request rate exceeded; retry_after is returned in the body and Retry-After in the response headers.