CEF Radar Events API

openapi: 3.2.0
info:
  title: CEF Radar Events API
  description: 'Everything CEF Radar says about a U.S. closed-end fund - who is targeting it, what it is asking holders to do and by when, what it costs, how much it borrows and what it holds - as plain JSON, read from public filings at the U.S. Securities and Exchange Commission. Every fact carries `as_of` and `source_url`; every answer carries a `notice` and a `Link: rel="terms-of-service"` header. Information, not advice. 100 requests a day per address without a key; `Authorization: Bearer ` raises the budget to the plan''s. Assistants have their own server (Model Context Protocol) at https://cefradar.com/mcp; a plain-text guide is at https://cefradar.com/llms.txt.'
  termsOfService: https://cefradar.com/terms#api
  contact:
    name: CEF Radar
    url: https://cefradar.com/for-developers
  license:
    name: CC BY 4.0 (the compiled data; text all rights reserved)
    url: https://creativecommons.org/licenses/by/4.0/
  version: 0.1.0
servers:
- url: https://cefradar.com
tags:
- name: Events
  description: Dated announcements a holder may need to act on, with the date to act by.
paths:
  /api/v1/funds/{ticker}/events:
    get:
      tags:
      - Events
      summary: 'One fund''s dated announcements, newest first: buy-back offers, votes, closings…'
      description: Corporate actions for one fund, newest first (tender offers, votes, closings, mergers, offerings, payouts).
      operationId: get_fund_events
      parameters:
      - name: ticker
        in: path
        required: true
        schema:
          type: string
          title: Ticker
      - name: kind
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Kind
      - name: open
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 1 = only open (act-on) events
          title: Open
        description: 1 = only open (act-on) events
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Get Fund Events
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/events:
    get:
      tags:
      - Events
      summary: Recent announcements across every closed-end fund, newest first, with the date…
      description: Corporate actions across funds, newest first.
      operationId: list_events
      parameters:
      - name: kind
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: event kind, e.g. tender_offer
          title: Kind
        description: event kind, e.g. tender_offer
      - name: since
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: YYYY-MM-DD (filed_at >= since)
          title: Since
        description: YYYY-MM-DD (filed_at >= since)
      - name: until
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: YYYY-MM-DD (filed_at <= until)
          title: Until
        description: YYYY-MM-DD (filed_at <= until)
      - name: cef
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 1 = closed-end funds only (default), 0 = all issuers
          default: '1'
          title: Cef
        description: 1 = closed-end funds only (default), 0 = all issuers
      - name: issuer
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: fund ticker
          title: Issuer
        description: fund ticker
      - name: open
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 1 = only open (act-on) events
          title: Open
        description: 1 = only open (act-on) events
      - name: page
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          default: 1
          title: Page
      - name: per_page
        in: query
        required: false
        schema:
          type: integer
          maximum: 200
          minimum: 1
          default: 50
          title: Per Page
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response List Events
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    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