---
title: "Get Smart Feed"
method: GET
path: "/api/confluence/smart-feed"
tags: ["Confluence"]
---

# Get Smart Feed

`GET /api/confluence/smart-feed`

## Request

- Base URL: `https://alpha-bazaar-signal-server.onrender.com`
- URL: `https://alpha-bazaar-signal-server.onrender.com/api/confluence/smart-feed`
- Auth: none required

Return algorithmically ranked signal confluences

Args:
    horizon: Filter by time horizon (intraday, swing, position, long)
    signal_freshness: Filter by freshness (all_fresh, mixed, all_delayed)
    min_score: Minimum confluence quality score threshold
    min_actionability: Minimum actionability score (0=past, 70+=go)
    actionability_filter: Filter by actionability label (go, caution, stop, past)
    sort_by: Sorting method (score, fresh, strength, recent, actionability)
    limit: Maximum results to return
    offset: Pagination offset
    include_trade_context: Include trade_context enrichment (default True)
    user: Current authenticated user

Returns:
    Dict with events list, pagination info, and disclaimers

## Query parameters

- `horizon` string, nullable: Time horizon filter (intraday/swing/position)
- `signal_freshness` string, nullable: Signal freshness filter
- `min_score` number: Minimum confluence score
- `min_actionability` number, nullable: Minimum actionability score (0=past, 70+=go)
- `actionability_filter` string, nullable: Filter by actionability: go (≥70), caution (40-69), stop (1-39), past (0)
- `side` string, nullable: Filter by signal side (buy, sell, or short)
- `has_politician` boolean, nullable: Filter to events with politician sources
- `has_whale` boolean, nullable: Filter to events with whale sources
- `has_analyst` boolean, nullable: Filter to events with analyst sources
- `has_community` boolean, nullable: Filter to events with community/publisher sources
- `min_analysts` integer, nullable: Minimum number of analyst sources
- `max_age_days` integer, nullable: Max age in days since detection
- `sort_by` string: Sort field
- `limit` integer: Results per page
- `offset` integer: Number of results to skip
- `include_total` boolean: Include total count (slower, for UI compatibility)
- `include_trade_context` boolean: Include trade_context enrichment (tags, narrative). Set to false for faster initial loads.

## Response `200`

Successful Response

- SmartFeedResponse: GET /api/confluence/smart-feed
  - `events` SmartFeedEvent[], required
    - `id` string, required
    - `ticker` string, required
    - `action` string, required
    - `confluence_type` string, nullable
    - `confluence_score` number, nullable
    - `actionability_score` number, nullable
    - `actionability_label` string, nullable
    - `signal_freshness` string, nullable
    - `last_join_at` string, nullable
    - `latest_price` number, nullable
    - `price_at_detection` number, nullable
    - `current_return` number, nullable
    - `confirmations` ConfluenceConfirmation[]
      - `signal_id` string, required
      - `publisher_username` string, nullable
      - `publisher_type` string, nullable
      - `publisher_avg_return` number, nullable
      - `publisher_win_rate` number, nullable
      - `horizon` string, nullable
      - `signal_action` string, nullable
      - `entry_price` number, nullable
      - `created_at` string, nullable
      - `is_verified_trade` boolean, nullable
    - `detection_metadata` ConfluenceDetectionMetadata
      - `original_score` number, nullable
      - `first_detected_at` string, nullable
      - `members_joined_after_detection` integer, nullable
    - `verified_confirmation_count` integer, nullable
    - `has_verified_backing` boolean, nullable
  - `offset` integer, required
  - `limit` integer, required
  - `has_more` boolean
  - `total` integer, nullable
  - `graph_data` unknown
  - `disclaimers` SmartFeedDisclaimers
    - `investment_advice` string, nullable
    - `historical_performance` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/alphabazaar/apis/alpha-bazaar-signal-server.md) · [All operations](https://skmtc.dev/alphabazaar/apis/alpha-bazaar-signal-server/llms.txt) · [OpenAPI document](https://skmtc.dev/alphabazaar/apis/alpha-bazaar-signal-server/revisions/d52b2182fb25?raw)