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:

Feed Description
News Feed Breaking 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

Method Path Description
POST /api/feeds/news/subscribe Subscribe to news feed
POST /api/feeds/news/unsubscribe Unsubscribe from news feed
GET /api/feeds/news Latest news items
GET /api/feeds/news/categories List available categories
GET /api/feeds/news/status Subscription 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

Category Description
Crypto Cryptocurrency market news
Politics Political developments
Economics Economic indicators and analysis
Technology Technology and software news
Regulatory Financial regulation updates
Entertainment Media and cultural trends
Sports Sports 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.