Get Latest News Feed#
Retrieve the latest cryptocurrency news feed. Internally sortBy=latest is fixed; importance has no server-side default — omit to skip the filter.
Request Path#
GET
https://web3.okx.com/api/v6/dex/market/social/news/latestRequest Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| tokenSymbols | string | No | Comma-separated list of token symbols, e.g. BTC,ETH,SOL. Case-insensitive. Omit to return data for all tokens. Maximum 20 symbols supported. |
| begin | string | No | Query start timestamp (milliseconds). Defaults to current time − 72 hours; maximum lookback of 180 days. |
| end | string | No | Query end timestamp (milliseconds). Defaults to current time (now). |
| importance | string | No | SocialImportanceEnum code to filter by article importance: 1=high, 2=medium, 3=low. Omit to return all importance levels. |
| platform | string | No | News source domain, e.g. coindesk.com. Retrieve the full list via GET /social/news/platforms. Omit to return data from all sources. |
| limit | string | No | Number of results per page, range [1, 50], default 10. |
| cursor | string | No | Pagination cursor. Omit on first request; pass the cursor from the previous response to fetch the next page. A null cursor indicates no more data. |
| detailLevel | string | No | Response detail level: 1=summary (title + summary only, content field is empty), 2=full (also returns full article content). Default 1. Use 1 for list views and 2 for detail views to reduce bandwidth. |
| language | string | No | Response language in BCP-47 format, e.g. en_US, zh_CN. Default en_US. Supported locales depend on the upstream Orbit service. |
Response Parameters#
| Field | Type | Description |
|---|---|---|
| cursor | string | Next-page cursor; null indicates no more data |
| articles | array | List of news articles |
| > id | string | Unique article ID, can be used as the id parameter of GET /social/news/detail to retrieve the full article |
| > title | string | Article title |
| > summary | string | Article summary |
| > content | string | Full article content; only returned when detailLevel=2 |
| > sourceUrl | string | Original article URL |
| > source | string | First platform domain of the news source, e.g. coindesk.com |
| > timestamp | string | Article publish time, Unix millisecond timestamp |
| > tokenSymbols | array | List of token symbols mentioned in the article |
| > importance | string | Article importance level: high, medium, or low |
| > tokenSymbolSentiments | array | Per-token sentiment analysis for this article |
| >> sentiment | string | Sentiment label: bullish / bearish / neutral |
| >> tokenSymbol | string | Token symbol |
Request Example#
shell
curl --location --request GET 'https://web3.okx.com/api/v6/dex/market/social/news/latest?limit=10&detailLevel=1&language=en_US' \
--header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \
--header 'OK-ACCESS-SIGN: leaV********3uw=' \
--header 'OK-ACCESS-PASSPHRASE: 1****6' \
--header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z'
Response Example#
json
{
"code": "0",
"msg": "",
"data": {
"cursor": "eyJsYXN0SWQiOiIxNzM4MDAwMDAwMDAxIn0",
"articles": [
{
"id": "NEWS_20241018_001",
"title": "Bitcoin Surges Past $70,000 as Institutional Demand Grows",
"summary": "Bitcoin has broken through the $70,000 mark for the first time this month, driven by strong institutional buying and positive ETF inflows.",
"content": "",
"sourceUrl": "https://coindesk.com/markets/2024/10/18/bitcoin-surges-past-70000",
"source": "coindesk.com",
"timestamp": "1697630501000",
"tokenSymbols": ["BTC"],
"importance": "high",
"tokenSymbolSentiments": [
{
"tokenSymbol": "BTC",
"sentiment": "bullish"
}
]
},
{
"id": "NEWS_20241018_002",
"title": "Ethereum Developers Finalize Next Upgrade Timeline",
"summary": "Core Ethereum developers have agreed on a timeline for the next major network upgrade, focusing on scalability improvements.",
"content": "",
"sourceUrl": "https://cointelegraph.com/news/ethereum-upgrade-timeline",
"source": "cointelegraph.com",
"timestamp": "1697627000000",
"tokenSymbols": ["ETH"],
"importance": "medium",
"tokenSymbolSentiments": [
{
"tokenSymbol": "ETH",
"sentiment": "bullish"
}
]
}
]
}
}