News

The News endpoints return the latest articles related to specific tokens, identified by either token ID or symbol. Each article includes metadata like headline, source, and sentiment.

Endpoint Overview

Method	Endpoint	Description
GET	/v1/news/{tokenId}	Retrieves latest news related to a specific token ID.
GET	/v1/news/symbol/{symbol}	Retrieves latest news articles for a given ticker symbol.

---

Retrieve News by Token Symbol

GET /v1/news/symbol/{symbol}

Purpose: Fetches recent news articles related to a specific cryptocurrency identified by its token symbol.

Path Parameters:

Name	Type	Mandatory	Description
symbol	string	Yes	Cryptocurrency token symbol (e.g., "SOL").

Example Request:

GET /v1/news/symbol/SOL

Example Response:

{
  "data": [
    {
      "articleUrl": "https://ambcrypto.com/mapping-solanas-short-term-price-targets-key-levels-to-watch/",
      "imageUrl": "https://crypto.snapi.dev/images/v1/z/w/5/solana-1-1-659845.webp",
      "headline": "Mapping Solana's short-term price targets — Key levels to watch!",
      "content": "Solana is forming a broadening wedge on the charts...",
      "source": "AMBCrypto",
      "publishedDate": "2025-03-09T05:00:42+00:00",
      "topics": ["tanalysis"],
      "sentiment": "Neutral",
      "category": "Article",
      "relatedSymbols": ["SOL"]
    },
    {
      "articleUrl": "https://ambcrypto.com/solana-heres-how-sol-is-gaining-ground-with-institutions-like-galaxy/",
      "imageUrl": "https://crypto.snapi.dev/images/v1/y/h/k/solanafii-659775.jpg",
      "headline": "Solana — Here's how SOL is gaining ground with institutions like Galaxy",
      "content": "There has been a sharp market sentiment difference...",
      "source": "AMBCrypto",
      "publishedDate": "2025-03-08T19:00:22+00:00",
      "topics": ["institutions"],
      "sentiment": "Positive",
      "category": "Article",
      "relatedSymbols": ["SOL"]
    }
  ],
  "success": true,
  "timestamp": 1741501294583,
  "requestId": "1b2a6f78-55fa-479f-a3e0-36f6d228fa4f",
  "message": "",
  "error": null
}

---

Retrieve News by Token ID

GET /v1/news/{tokenId}

Purpose: Fetches recent news articles related to a specific cryptocurrency identified by its numeric token ID.

Path Parameters:

Name	Type	Mandatory	Description
tokenId	number	Yes	Numeric ID representing the cryptocurrency (e.g., 130 for Bitcoin).

Example Request:

GET /v1/news/130

Example Response:

{
  "data": [
    {
      "articleUrl": "https://ambcrypto.com/btc-tops-86000-what-is-next/",
      "imageUrl": "https://crypto.snapi.dev/images/.../btc-1-658932.webp",
      "headline": "BTC tops $86,000 — Where does it go from here?",
      "content": "Bitcoin sees record highs, crossing $86k for the first time this quarter...",
      "source": "AMBCrypto",
      "publishedDate": "2025-03-09T05:00:42+00:00",
      "topics": ["tanalysis"],
      "sentiment": "Neutral",
      "category": "Article",
      "relatedSymbols": ["BTC"]
    }
  ],
  "success": true,
  "timestamp": 1741501294583,
  "requestId": "some-request-id",
  "message": "",
  "error": null
}

Response Structure:

Structure identical to the symbol-based news endpoint.

---

Usage Notes

• Symbol vs. Token ID:
• If multiple tokens share the same symbol, the API defaults to the highest market cap token.
• For absolute clarity, use the token ID route.
• Article Freshness:
• The API aggregates from multiple sources; the count and freshness of articles may vary.
• Pagination:
• Some implementations may allow pagination in the future, but typically news returns the latest items up to a certain limit (not explicitly shown in this response).

---