opennews

$2c

Authentication

All requests require the header:

Authorization: Bearer $OPENNEWS_TOKEN

News Operations

1. Get News Sources

Fetch the full engine tree with all 6 categories and 84+ sources.

curl -s -H "Authorization: Bearer $OPENNEWS_TOKEN" \

  "https://ai.6551.io/open/news_type"

Returns a tree with engine types (news — 53 sources, listing — 9 exchanges, onchain — 3 whale/KOL trackers, meme — 1 sentiment source, market — 6 anomaly signals, prediction — 12 AI prediction signals) and their sub-categories.

2. Search News

POST /open/news_search is the primary search endpoint.

Get latest news:

curl -s -X POST "https://ai.6551.io/open/news_search" \

  -H "Authorization: Bearer $OPENNEWS_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"limit": 10, "page": 1}'

Search by keyword:

curl -s -X POST "https://ai.6551.io/open/news_search" \

  -H "Authorization: Bearer $OPENNEWS_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"q": "bitcoin OR ETF", "limit": 10, "page": 1}'

Search by coin symbol:

curl -s -X POST "https://ai.6551.io/open/news_search" \

  -H "Authorization: Bearer $OPENNEWS_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"coins": ["BTC"], "limit": 10, "page": 1}'

Filter by engine type and news type:

curl -s -X POST "https://ai.6551.io/open/news_search" \

  -H "Authorization: Bearer $OPENNEWS_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"engineTypes": {"news": ["Bloomberg", "Reuters"]}, "limit": 10, "page": 1}'

Only news with coins:

curl -s -X POST "https://ai.6551.io/open/news_search" \

  -H "Authorization: Bearer $OPENNEWS_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"hasCoin": true, "limit": 10, "page": 1}'

News Search Parameters

Parameter

Type

Required

Description

limit

integer

yes

Max results per page (1-100)

page

integer

yes

Page number (1-based)

q

string

no

Full-text keyword search

coins

string[]

no

Filter by coin symbols (e.g. ["BTC","ETH"])

engineTypes

map[string][]string

no

Filter by engine and news types

hasCoin

boolean

no

Only return news with associated coins

score

integer

no

Filter by minimum AI score (0-100)

Important: You need to understand the user's query intent and perform word segmentation, then combine them using OR/AND to form search keywords, supporting both Chinese and English.

Data Structures

News Article

{

  "id": "unique-article-id",

  "text": "Article headline / content",

  "newsType": "Bloomberg",

  "engineType": "news",

  "link": "https://...",

  "coins": [{"symbol": "BTC", "market_type": "cex", "match": "title"}],

  "aiRating": {

    "score": 85,

    "grade": "A",

    "signal": "long",

    "status": "done",

    "summary": "Chinese summary",

    "enSummary": "English summary"

  },

  "ts": 1708473600000

}

Common Workflows

Quick Market Overview

curl -s -X POST "https://ai.6551.io/open/news_search" \

  -H "Authorization: Bearer $OPENNEWS_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"limit": 10, "page": 1}' | jq '.data[] | {text, newsType, signal: .aiRating.signal}'

High-Impact News (score >= 80)

curl -s -X POST "https://ai.6551.io/open/news_search" \

  -H "Authorization: Bearer $OPENNEWS_TOKEN" \

  -H "Content-Type: application/json" \

  -d '{"score": 80, "limit": 50, "page": 1}'

Free API Endpoints (No Token Required)

If you don't have an OPENNEWS_TOKEN, you can use these free endpoints as a fallback. These provide curated hot news and trending tweets by category, but with limited search capabilities compared to the authenticated API.

1. Get Free News Categories

Get all available news categories and subcategories for the free tier.

curl -s -X GET "https://ai.6551.io/open/free_categories"

2. Get Hot News by Category

Get hot news articles and trending tweets by category. No authentication required.

curl -s -X GET "https://ai.6551.io/open/free_hot?category=macro"

Parameters:

Parameter

Type

Required

Description

category

string

yes

Category key from free_categories

subcategory

string

no

Subcategory key for more specific filtering

Response Structure:

{

  "success": true,

  "category": "crypto",

  "subcategory": "defi",

  "news": {

    "success": true,

    "count": 10,

    "items": [

      {

        "id": 123,

        "title": "...",

        "source": "...",

        "link": "https://...",

        "score": 85,

        "grade": "A",

        "signal": "bullish",

        "summary_zh": "...",

        "summary_en": "...",

        "coins": ["BTC", "ETH"],

        "published_at": "2026-03-17T10:00:00Z"

      }

    ]

  },

  "tweets": {

    "success": true,

    "count": 5,

    "items": [

      {

        "author": "Vitalik Buterin",

        "handle": "VitalikButerin",

        "content": "...",

        "url": "https://...",

        "metrics": { "likes": 1000, "retweets": 200, "replies": 50 },

        "posted_at": "2026-03-17T09:00:00Z",

        "relevance": "high"

      }

    ]

  }

}

Example - Get Hot Crypto News:

curl -s -X GET "https://ai.6551.io/open/free_hot?category=macro"

Example - Get DeFi Subcategory News:

curl -s -X GET "https://ai.6551.io/open/free_hot?category=macro&subcategory=defi"

Notes

• Primary API: Get your token at https://6551.io/mcp for full access to 84+ sources with advanced search

• Free API: Use free endpoints as fallback when token is unavailable (limited to curated hot news)

• Rate limits apply; max 100 results per request for authenticated API

• AI ratings may not be available on all articles (check status == "done")

• Free API data is cached and updated periodically; if data is still being generated, a 503 response will be returned