Alpha Bazaar Confluence API

Smart feed and signal overlap detection

Operations 7

GET /api/confluence/smart-feed Get Smart Feed #
GET /api/confluence/health Confluence Health #
GET /api/confluence/metrics Confluence Metrics #
GET /api/confluence/{confluence_id}/score-history Get Confluence Score History #
GET /api/confluence/{confluence_id}/ptr-attribution Get Confluence Ptr Attribution #
GET /api/confluence/{confluence_id}/timing-breakdown Get Confluence Timing Breakdown #
POST /api/confluence/update-overlaps Update Overlap Matrix #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/alphabazaar-ai:alphabazaar-ai-confluence-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

alphabazaar-ai-confluence-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Alphabazaar Ai Confluence API
  version: 2.2.0-socketio
  contact:
    name: Alpha Bazaar
    url: https://alphabazaar.ai/
    email: support@alphabazaar.ai
  license:
    name: Proprietary
  termsOfService: https://www.alphabazaar.ai/legal/terms
  description: 'Operations tagged Confluence across 2 of this provider''s published API definitions: alphabazaar-ai-openapi.yml, openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://alpha-bazaar-signal-server.onrender.com
  description: Production
- url: https://dev-alpha-bazaar-signal-server.onrender.com
  description: Staging
security:
- HTTPBearer: []
tags:
- name: Confluence
  description: Smart feed and signal overlap detection
paths:
  /api/confluence/smart-feed:
    get:
      tags:
      - Confluence
      summary: Get Smart Feed
      description: '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'
      operationId: get_smart_feed_api_confluence_smart_feed_get
      security: []
      parameters:
      - name: horizon
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            pattern: ^(intraday|swing|position|long)$
          - type: 'null'
          description: Time horizon filter (intraday/swing/position)
          title: Horizon
        description: Time horizon filter (intraday/swing/position)
      - name: signal_freshness
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            pattern: ^(all_fresh|mixed|all_delayed)$
          - type: 'null'
          description: Signal freshness filter
          title: Signal Freshness
        description: Signal freshness filter
      - name: min_score
        in: query
        required: false
        schema:
          type: number
          maximum: 100
          minimum: 0
          description: Minimum confluence score
          default: 0.0
          title: Min Score
        description: Minimum confluence score
      - name: min_actionability
        in: query
        required: false
        schema:
          anyOf:
          - type: number
            maximum: 100
            minimum: 0
          - type: 'null'
          description: Minimum actionability score (0=past, 70+=go)
          title: Min Actionability
        description: Minimum actionability score (0=past, 70+=go)
      - name: actionability_filter
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            pattern: ^(go|caution|stop|past)$
          - type: 'null'
          description: 'Filter by actionability: go (≥70), caution (40-69), stop (1-39), past (0)'
          title: Actionability Filter
        description: 'Filter by actionability: go (≥70), caution (40-69), stop (1-39), past (0)'
      - name: side
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            pattern: ^(buy|sell|short)$
          - type: 'null'
          description: Filter by signal side (buy, sell, or short)
          title: Side
        description: Filter by signal side (buy, sell, or short)
      - name: has_politician
        in: query
        required: false
        schema:
          anyOf:
          - type: boolean
          - type: 'null'
          description: Filter to events with politician sources
          title: Has Politician
        description: Filter to events with politician sources
      - name: has_whale
        in: query
        required: false
        schema:
          anyOf:
          - type: boolean
          - type: 'null'
          description: Filter to events with whale sources
          title: Has Whale
        description: Filter to events with whale sources
      - name: has_analyst
        in: query
        required: false
        schema:
          anyOf:
          - type: boolean
          - type: 'null'
          description: Filter to events with analyst sources
          title: Has Analyst
        description: Filter to events with analyst sources
      - name: has_community
        in: query
        required: false
        schema:
          anyOf:
          - type: boolean
          - type: 'null'
          description: Filter to events with community/publisher sources
          title: Has Community
        description: Filter to events with community/publisher sources
      - name: min_analysts
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
            minimum: 1
          - type: 'null'
          description: Minimum number of analyst sources
          title: Min Analysts
        description: Minimum number of analyst sources
      - name: max_age_days
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
            maximum: 365
            minimum: 1
          - type: 'null'
          description: Max age in days since detection
          title: Max Age Days
        description: Max age in days since detection
      - name: sort_by
        in: query
        required: false
        schema:
          type: string
          pattern: ^(score|fresh|strength|recent|actionability|hot|price_change_asc|price_change_desc)$
          description: Sort field
          default: score
          title: Sort By
        description: Sort field
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          description: Results per page
          default: 20
          title: Limit
        description: Results per page
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          description: Number of results to skip
          default: 0
          title: Offset
        description: Number of results to skip
      - name: include_total
        in: query
        required: false
        schema:
          type: boolean
          description: Include total count (slower, for UI compatibility)
          default: true
          title: Include Total
        description: Include total count (slower, for UI compatibility)
      - name: include_trade_context
        in: query
        required: false
        schema:
          type: boolean
          description: Include trade_context enrichment (tags, narrative). Set to false for faster initial loads.
          default: true
          title: Include Trade Context
        description: Include trade_context enrichment (tags, narrative). Set to false for faster initial loads.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SmartFeedResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: https://alpha-bazaar-signal-server.onrender.com
      description: Production
    - url: https://dev-alpha-bazaar-signal-server.onrender.com
      description: Staging
  /api/confluence/health:
    get:
      tags:
      - Confluence
      summary: Confluence Health
      description: 'System health check for confluence feed


        Returns:

        Health status with component checks'
      operationId: confluence_health_api_confluence_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security: []
    servers:
    - url: https://alpha-bazaar-signal-server.onrender.com
      description: Production
    - url: https://dev-alpha-bazaar-signal-server.onrender.com
      description: Staging
  /api/confluence/metrics:
    get:
      tags:
      - Confluence
      summary: Confluence Metrics
      description: 'Performance metrics for confluence feed


        Args:

        user: Current authenticated user


        Returns:

        Dict with metrics'
      operationId: confluence_metrics_api_confluence_metrics_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - HTTPBearer: []
    servers:
    - url: https://alpha-bazaar-signal-server.onrender.com
      description: Production
    - url: https://dev-alpha-bazaar-signal-server.onrender.com
      description: Staging
  /api/confluence/{confluence_id}/score-history:
    get:
      tags:
      - Confluence
      summary: Get Confluence Score History
      description: 'Return historical confluence score snapshots for sparkline visualization.


        Public endpoint (no auth required). Returns up to 90 days of daily score data.'
      operationId: get_confluence_score_history_api_confluence__confluence_id__score_history_get
      parameters:
      - name: confluence_id
        in: path
        required: true
        schema:
          type: string
          description: Confluence event UUID
          title: Confluence Id
        description: Confluence event UUID
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: https://alpha-bazaar-signal-server.onrender.com
      description: Production
    - url: https://dev-alpha-bazaar-signal-server.onrender.com
      description: Staging
  /api/confluence/{confluence_id}/ptr-attribution:
    get:
      tags:
      - Confluence
      summary: Get Confluence Ptr Attribution
      description: 'Get PTR attribution analysis for a confluence


        Compare insider returns (from trade_date) vs public returns (from filing_date+1)

        to measure information decay due to disclosure lag.


        Args:

        confluence_id: Confluence event ID

        window_days: Forward return window (default: 30 days)

        user: Current authenticated user


        Returns:

        Dict with attribution metrics:

        - avg_insider_return: Average return from politician trade dates

        - avg_public_return: Average return from filing dates

        - avg_info_decay: Average information decay (insider - public)

        - decay_percentage: Decay as percentage of insider return

        - sample_size: Number of PTRs analyzed

        - window_days: Time window used'
      operationId: get_confluence_ptr_attribution_api_confluence__confluence_id__ptr_attribution_get
      security:
      - HTTPBearer: []
      parameters:
      - name: confluence_id
        in: path
        required: true
        schema:
          type: string
          description: Confluence event UUID
          title: Confluence Id
        description: Confluence event UUID
      - name: window_days
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          description: Lookback window in days
          default: 30
          title: Window Days
        description: Lookback window in days
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: https://alpha-bazaar-signal-server.onrender.com
      description: Production
    - url: https://dev-alpha-bazaar-signal-server.onrender.com
      description: Staging
  /api/confluence/{confluence_id}/timing-breakdown:
    get:
      tags:
      - Confluence
      summary: Get Confluence Timing Breakdown
      description: 'Get timing classification breakdown for a confluence


        Shows how many confirmations fell into each timing category:

        - BLIND_CONFIRMATION: Signal between trade_date and filing_date

        - LEADING: Signal before politician''s trade_date

        - INDEPENDENT: Analyst signal before filing_date

        - QUICK_FOLLOW: Signal within 2 days of filing

        - POST_DISCLOSURE: Signal after filing_date

        - LATE_CONFIRMATION: Signal 3+ days after filing

        - UNKNOWN: Can''t determine timing


        Args:

        confluence_id: Confluence event ID

        user: Current authenticated user


        Returns:

        Dict with counts per timing type and detailed confirmations'
      operationId: get_confluence_timing_breakdown_api_confluence__confluence_id__timing_breakdown_get
      security:
      - HTTPBearer: []
      parameters:
      - name: confluence_id
        in: path
        required: true
        schema:
          type: string
          description: Confluence event UUID
          title: Confluence Id
        description: Confluence event UUID
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: https://alpha-bazaar-signal-server.onrender.com
      description: Production
    - url: https://dev-alpha-bazaar-signal-server.onrender.com
      description: Staging
  /api/confluence/update-overlaps:
    post:
      tags:
      - Confluence
      summary: Update Overlap Matrix
      description: 'Manually trigger overlap matrix update (admin only)


        Args:

        user: Current authenticated user


        Returns:

        Update statistics'
      operationId: update_overlap_matrix_api_confluence_update_overlaps_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - HTTPBearer: []
    servers:
    - url: https://alpha-bazaar-signal-server.onrender.com
      description: Production
    - url: https://dev-alpha-bazaar-signal-server.onrender.com
      description: Staging
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    ConfluenceDetectionMetadata:
      properties:
        original_score:
          anyOf:
          - type: number
          - type: 'null'
          title: Original Score
        first_detected_at:
          anyOf:
          - type: string
          - type: 'null'
          title: First Detected At
        members_joined_after_detection:
          anyOf:
          - type: integer
          - type: 'null'
          title: Members Joined After Detection
      type: object
      title: ConfluenceDetectionMetadata
    SmartFeedEvent:
      properties:
        id:
          type: string
          title: Id
        ticker:
          type: string
          title: Ticker
        action:
          type: string
          title: Action
        confluence_type:
          anyOf:
          - type: string
          - type: 'null'
          title: Confluence Type
        confluence_score:
          anyOf:
          - type: number
          - type: 'null'
          title: Confluence Score
        actionability_score:
          anyOf:
          - type: number
          - type: 'null'
          title: Actionability Score
        actionability_label:
          anyOf:
          - type: string
          - type: 'null'
          title: Actionability Label
        signal_freshness:
          anyOf:
          - type: string
          - type: 'null'
          title: Signal Freshness
        last_join_at:
          anyOf:
          - type: string
          - type: 'null'
          title: Last Join At
        latest_price:
          anyOf:
          - type: number
          - type: 'null'
          title: Latest Price
        price_at_detection:
          anyOf:
          - type: number
          - type: 'null'
          title: Price At Detection
        current_return:
          anyOf:
          - type: number
          - type: 'null'
          title: Current Return
        confirmations:
          items:
            $ref: '#/components/schemas/ConfluenceConfirmation'
          type: array
          title: Confirmations
          default: []
        detection_metadata:
          anyOf:
          - $ref: '#/components/schemas/ConfluenceDetectionMetadata'
          - type: 'null'
        verified_confirmation_count:
          anyOf:
          - type: integer
          - type: 'null'
          title: Verified Confirmation Count
        has_verified_backing:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Has Verified Backing
      type: object
      required:
      - id
      - ticker
      - action
      title: SmartFeedEvent
    SmartFeedResponse:
      properties:
        events:
          items:
            $ref: '#/components/schemas/SmartFeedEvent'
          type: array
          title: Events
        offset:
          type: integer
          title: Offset
        limit:
          type: integer
          title: Limit
        has_more:
          type: boolean
          title: Has More
          default: false
        total:
          anyOf:
          - type: integer
          - type: 'null'
          title: Total
        graph_data:
          anyOf:
          - {}
          - type: 'null'
          title: Graph Data
        disclaimers:
          anyOf:
          - $ref: '#/components/schemas/SmartFeedDisclaimers'
          - type: 'null'
      type: object
      required:
      - events
      - offset
      - limit
      title: SmartFeedResponse
      description: GET /api/confluence/smart-feed
    ConfluenceConfirmation:
      properties:
        signal_id:
          type: string
          title: Signal Id
        publisher_username:
          anyOf:
          - type: string
          - type: 'null'
          title: Publisher Username
        publisher_type:
          anyOf:
          - type: string
          - type: 'null'
          title: Publisher Type
        publisher_avg_return:
          anyOf:
          - type: number
          - type: 'null'
          title: Publisher Avg Return
        publisher_win_rate:
          anyOf:
          - type: number
          - type: 'null'
          title: Publisher Win Rate
        horizon:
          anyOf:
          - type: string
          - type: 'null'
          title: Horizon
        signal_action:
          anyOf:
          - type: string
          - type: 'null'
          title: Signal Action
        entry_price:
          anyOf:
          - type: number
          - type: 'null'
          title: Entry Price
        created_at:
          anyOf:
          - type: string
          - type: 'null'
          title: Created At
        is_verified_trade:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Is Verified Trade
      type: object
      required:
      - signal_id
      title: ConfluenceConfirmation
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    SmartFeedDisclaimers:
      properties:
        investment_advice:
          anyOf:
          - type: string
          - type: 'null'
          title: Investment Advice
        historical_performance:
          anyOf:
          - type: string
          - type: 'null'
          title: Historical Performance
      type: object
      title: SmartFeedDisclaimers
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer
externalDocs:
  description: Agent integration guide and full API docs
  url: https://www.alphabazaar.ai/llms-full.txt
x-refined-from:
- alphabazaar-ai-openapi.yml
- openapi.json