Alpha Alerts API

Get crypto market insights in real-time.

Alpha Alerts API has been deprecated in favor of the #knowledge-wizard, our new method of delivering our Universal Agents and Fractal data infra to B2B.

Knowledge Search

---

Fetch the most recent crypto market news and discussions.

Parameters:

• query: what you want to search for; the more specific, the better.

• count: how many documents to return. Allowed range: 1-20, default: 10.

• offset: how many documents to skip.

• sort_by: whether to sort documents by date or by their relevance score. We recommend using date for most cases, but relevance could work better for very niche queries.

• sources: categories of documents to search. Should include at least one of those: news, 4chan.

Note that at the moment, the summary field of each document returned by this endpoint will be equal to null.

Search Knowledge Documents

post

Search knowledge documents

Authorizations

Header parameters

turnstile-authorizationany ofOptional

stringOptional

or

nullOptional

Body

querystringRequired

countinteger · min: 1 · max: 20OptionalDefault: 10

offsetintegerOptionalDefault: 0

sort_bystring · enumOptionalDefault: datePossible values:

Responses

200

Successful Response

application/json

422

Validation Error

application/json

post

HTTPcURLJavaScriptPython

POST /knowledge/search HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 74

{
  "query": "text",
  "count": 10,
  "offset": 0,
  "sort_by": "date",
  "sources": [
    "news"
  ]
}

{
  "documents": [
    {
      "summary": "text",
      "title": "text",
      "tldr": "text",
      "source": "text",
      "last_time_updated": "2025-05-16T10:00:04.720Z",
      "bullishness": 1,
      "legitimacy": 1
    }
  ],
  "count": 10,
  "offset": 0,
  "total_found": 1
}

Coming in the next update

• More structured data fields (hashtags, impact, assets mentioned, market sectors, etc.)

• Custom threshold for the similarity score

• Return the contents of the summary field

API Costs

---

The pricing for the API is per request and depends on the model used. Learn more about API Credits at API Pricing.

Endpoint	API Credits per request
Search	1