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 Subscription Pricing
News Feed Breaking News with multiple categories $0.10/hr

News Feeds

Subscribe

  1. Navigate to the Feeds page
  2. Select the “News Feed” card
  3. Press Space to toggle subscription on/off

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_cents": 10
}

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": 10
}

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

Each Feed subscription is priced at a fixed rate like $0.10/hour, billed hourly from your credits balance. Unsubscribe anytime to stop charges. You can check the latest price on the Domains page in the TUI, or call the /api/feeds/pricing endpoint.