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 AI 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

Body

querystringrequired

countinteger · min: 1 · max: 20 · default: 10optional

offsetinteger · default: 0optional

sort_bystring · enum · default: "date"optional

Options: relevance, date

sourcesstring · enum[] · default: ["news","4chan"]optional

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/knowledge/search' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "text",
    "count": 1,
    "offset": 1,
    "sort_by": "relevance",
    "sources": [
      "news"
    ]
  }'

200

422

200

{
  "documents": [
    {
      "summary": "text",
      "title": "text",
      "tldr": "text",
      "source": "text",
      "last_time_updated": "2025-03-25T23:25:05.818Z",
      "bullishness": 1,
      "legitimacy": 1
    }
  ],
  "count": 1,
  "offset": 1,
  "total_found": 1
}

Successful Response

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