Feeds

Perceptron Feeds provide real-time data streams for AI agents to connect themselves to data they otherwise would need to search for with inefficient methods.

Perceptron currently offers the following feeds you can subscribe to:

FeedDescription
News FeedBreaking News with multiple categories

News Feeds

Subscribe

  1. Open the Feeds page in the Perceptron app
  2. Toggle the “News Feed” subscription on

API Reference

MethodPathDescription
POST/api/feeds/news/subscribeSubscribe to news feed
POST/api/feeds/news/unsubscribeUnsubscribe from news feed
GET/api/feeds/newsLatest news items
GET/api/feeds/news/categoriesList available categories
GET/api/feeds/news/statusSubscription status

API Authentication

Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Subscription

POST /api/feeds/news/subscribe

curl -X POST https://perceptron.cloud/api/feeds/news/subscribe \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "status": "subscribed",
  "prepaid_until": 1740000000,
  "hourly_cost": "x"
}

Unsubscription

POST /api/feeds/news/unsubscribe

curl -X POST https://perceptron.cloud/api/feeds/news/unsubscribe \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "status": "unsubscribed"
}

News Items

GET /api/feeds/news

curl 'https://perceptron.cloud/api/feeds/news?category=crypto&limit=20' \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "items": [
    {
      "id": "news_abc123",
      "timestamp": 1740000000,
      "category": "crypto",
      "headline": "Bitcoin Breaks $100K",
      "summary": "Bitcoin reached a new all-time high...",
      "source": "perceptron-analysis",
      "link": null
    }
  ]
}

Categories

GET /api/feeds/news/categories

curl https://perceptron.cloud/api/feeds/news/categories \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "categories": [
    { "id": "crypto", "name": "Crypto", "description": "Cryptocurrency market news" },
    { "id": "technology", "name": "Technology", "description": "Technology and software news" }
  ]
}

Subscription Status

GET /api/feeds/news/status

curl https://perceptron.cloud/api/feeds/news/status \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "feed_type": "news",
  "status": "Active",
  "subscribed_at": 1740000000,
  "prepaid_until": 1740003600,
  "hourly_cost": "x"
}

Categories

CategoryDescription
CryptoCryptocurrency market news
PoliticsPolitical developments
EconomicsEconomic indicators and analysis
TechnologyTechnology and software news
RegulatoryFinancial regulation updates
EntertainmentMedia and cultural trends
SportsSports news and scores

Pricing

Feed subscriptions are billed hourly from your credits balance. Unsubscribe anytime to stop charges. You can check the latest price on the Feeds page of the Perceptron app, or call the /api/feeds/pricing endpoint. See Billing for more details.