GateData.AI

Sentiment query

Query social and market sentiment.

GET/api/v1/signals/sentiment
Domain
Events, News, Sentiment & Signals
Level
Asset
MCP tool
events_news_query (task=sentiment)

Available data

Returns
Social and market sentiment
Market coverage
Crypto and US equities; sourced from X
Query granularity
One asset and one window per query; figures are window aggregates, not a full post list

Authentication

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

Query Parameters

tickerstringqueryExampleAAPLoptional

Ticker when used with market.

marketMarketqueryExampleus_equityoptional

us_equity | hk_equity | kr_equity | uk_equity | jp_equity | crypto

limitintegerqueryExample20optional

Max rows to return (up to 1000).

Response

dataobject
sentimentobject | null

Sentiment payload when available; null under no_data

object_ref_idstringExampleasset_btc

Object the score is about

platformstringExamplex

Source platform (e.g. x)

windowstringExample7d

Aggregation window (e.g. 7d)

sentiment_scorenumberExample50

Sentiment score

positive_rationumberExample0

Positive share

neutral_rationumberExample1

Neutral share

negative_rationumberExample0

Negative share

mention_countintegerExample4

Mention sample size

low_confidencebooleanExampletrue

True when the sample is thin

confidence_reasonstringExamplelow_sample_size

Why confidence is low (e.g. low_sample_size)

sample_refs[]string[]

Sample post refs when evidence fan-out is entitled

data_statusDataStatusExamplepartial

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

endpointstringExamplesignals.sentiment

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)

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

data_statusDataStatusExamplepartial

Mirror of readiness in metadata

limitations[]string[]Exampledata_partial

Known data limitations

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

Most recent object or response update time

partialbooleanExampletrue

Whether the response contains only a subset of fields

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.