> For the complete documentation index, see [llms.txt](https://docs.dapplooker.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapplooker.com/products/api-endpoints/core-data-apis/crypto-news.md).

# Crypto News

#### **Endpoint**

**GET** `https://api.dapplooker.com/v1/crypto-news`

#### **Query Parameters**

<table><thead><tr><th width="207.53515625">Parameter name</th><th width="103.6015625">Type</th><th width="119.30078125">Mandatory</th><th>Description</th></tr></thead><tbody><tr><td><code>apiKey</code></td><td>string</td><td>Yes</td><td>Your unique DappLooker API key used for authentication.</td></tr><tr><td><code>date</code></td><td>string</td><td>No</td><td>To get news for specific date. supported format: YYYY-MM-DD</td></tr><tr><td><code>tokens</code></td><td>string</td><td>NO</td><td>Tokens to filter, i.e. <code>BTC</code>, <code>ETH</code></td></tr><tr><td><code>category</code></td><td>string</td><td>No</td><td>Category of news: <code>perp-dex</code>, <code>ai-agents</code>,<code>crypto</code>,<code>ai</code></td></tr><tr><td><code>sortOrder</code></td><td>string</td><td>No</td><td>Sorting order <code>asc</code> / <code>desc</code></td></tr><tr><td><code>page</code></td><td>integer</td><td>No</td><td>Page number for pagination. Default: <code>1</code></td></tr><tr><td><code>pageSize</code></td><td>integer</td><td>No</td><td>Results per page. Default: <code>20</code></td></tr></tbody></table>

#### **Example Request**

bash

```bash
# Latest news feed
curl --location 'https://api.dapplooker.com/v1/crypto-news?api_key=<API_KEY>'

# For specific date
curl --location 'https://api.dapplooker.com/v1/crypto-news?api_key=<API_KEY>&date=2026-06-24'

# For specific tokens
curl --location 'https://api.dapplooker.com/v1/crypto-news?api_key=<API_KEY>&tokens=BTC,ETH'

# With pagination and sorting
curl --location 'https://api.dapplooker.com/v1/crypto-news?api_key=<API_KEY>?page=1&pageSize=10&sortOrder=DESC'


```

#### **Example Response**

json

```json
{
  "success": true,
  "data": {
    "news": [
      {
        "id": "1021ffdf-f5c0-48cc-b2e0-7be61f990713",
        "headline": "Solana surpasses major CEXs in DEX spot trading volume",
        "tokens": [
          {
            "ticker": "SOL",
            "icon": "https://icons.dapplooker.com/tokens/SOL.svg"
          }
        ],
        "source": "SolanaFloor",
        "sourceUrl": "https://x.com/SolanaFloor/status/2071488586999067041",
        "description": "Solana has surpassed major centralized exchanges such as Bybit, Coinbase, and Kraken in DEX spot trading volume, ranking second only to Binance last week. This underscores the growing competitive strength of Solana's DEX ecosystem, which has been increasingly challenging established centralized platforms due to the efficiency of its blockchain technology.",
        "shortContext": "Solana has surpassed major CEXs in DEX spot trading volume, ranking second only to Binance last week.",
        "sentiment": "bullish",
        "sentimentValue": 0.85,
        "feedCategories": [
          "crypto",
          "defi",
          "tech"
        ],
        "tokenTickers": [
          "SOL"
        ],
        "publishedAt": "2026-06-29T07:02:23.665Z",
        "publishedAtRelative": "5 minutes ago",
        "isExpired": false,
        "narrativeId": null
      },
      {
        "id": "ebc9ac92-e779-4051-9b59-68f032292bab",
        "headline": "Galaxy Digital CEO Warns Bitcoin Selloff Driven by MicroStrategy Confidence Crisis",
        "tokens": [
          {
            "ticker": "BTC",
            "icon": "https://icons.dapplooker.com/tokens/BTC.svg"
          }
        ],
        "source": "WuBlockchain",
        "sourceUrl": "https://x.com/WuBlockchain/status/2071236538206179593",
        "description": "Galaxy Digital CEO Mike Novogratz attributed Bitcoin's recent decline to a MicroStrategy-led breakdown in confidence, alongside the hawkish Fed stance from the June 2026 meeting. He cautioned that a drop below the $60,000–59,000 support zone could send BTC to $45,000.",
        "shortContext": "Novogratz warns a break below $59K could push BTC to $45K amid MicroStrategy confidence crisis.",
        "sentiment": "bearish",
        "sentimentValue": 0.90,
        "feedCategories": [
          "crypto",
          "bitcoin",
          "macro"
        ],
        "tokenTickers": [
          "BTC"
        ],
        "publishedAt": "2026-06-28T14:19:34.350Z",
        "publishedAtRelative": "17 hours ago",
        "isExpired": true,
        "narrativeId": null
      }
    ],
    "pagination": {
      "currentPage": 1,
      "totalPages": 217,
      "totalCount": 4333,
      "pageSize": 20,
      "hasNextPage": true,
      "hasPreviousPage": false
    }
  }
}
```

#### **Response Fields Explanation**

**News item fields** (`data.news[]`)

* `id` *(string)*: Unique story identifier (UUID).
* `headline` *(string)*: Short display headline for the story.
* `tokens` *(array)*: List of tokens tagged to this story. Each item includes:
  * `ticker` *(string)*: Token ticker symbol (e.g. `BTC`, `ETH`, `SOL`).
  * `icon` *(string)*: Token icon URL.
* `source` *(string)*: Handle or name of the original source (e.g. `Cointelegraph`, `WuBlockchain`, `lookonchain`).
* `sourceUrl` *(string)*: Direct URL to the original post or article.
* `description` *(string)*: Full-length story summary with context and market relevance.
* `shortContext` *(string)*: Condensed one-to-two sentence summary. Use this for compact feed UIs or agent context injection.
* `sentiment` *(string)*: Directional sentiment label for the story. Values: `bullish`, `bearish`.
* `sentimentValue` *(float)*: Sentiment conviction score between `0` and `1`. Higher values indicate stronger signal strength regardless of direction.
* `feedCategories` *(array of strings)*: Topic tags for this story. Possible values: `crypto`, `defi`, `macro`, `bitcoin`, `tech`, `rwa`, `on_chain_whale`, `hyperliquid`, `perps`, `ai_agents`, `dats`.
* `tokenTickers` *(array of strings)*: Flat list of ticker symbols tagged to this story — mirrors `tokens[].ticker`.
* `publishedAt` *(string)*: ISO 8601 timestamp of when the story was published.
* `publishedAtRelative` *(string)*: Human-readable relative time (e.g. `5 minutes ago`, `2 days ago`). Use in live feed UIs.
* `isExpired` *(boolean)*: Whether this story is considered time-sensitive and no longer active. `false` = story is fresh and actionable. `true` = story is older and may no longer be market-relevant.
* `narrativeId` *(string | null)*: Narrative cluster identifier if this story belongs to a tracked macro or token narrative. Null if not assigned.

**Pagination fields** (`data.pagination`)

* `currentPage` *(integer)*: The current page of results.
* `totalPages` *(integer)*: Total number of available pages.
* `totalCount` *(integer)*: Total number of stories across all pages.
* `pageSize` *(integer)*: Number of stories returned per page.
* `hasNextPage` *(boolean)*: Whether a next page of results exists.
* `hasPreviousPage` *(boolean)*: Whether a previous page of results exists.