{
  "openapi": "3.1.0",
  "info": {
    "title": "bluefin API",
    "version": "0.1.0",
    "description": "Federated finance-data facade over the existing BlueDoor *fin source APIs. Public routes are intent-first; source adapters remain internal implementation details and response provenance."
  },
  "servers": [
    {
      "url": "https://api.bluefin.dev"
    },
    {
      "url": "https://api.bluedoor.sh"
    },
    {
      "url": "https://api.bluefin.bluedoor.sh"
    }
  ],
  "x-bluefin-source-count": 26,
  "x-bluefin-internal-adapter-endpoint-count": 493,
  "x-bluefin-mapped-adapter-endpoint-count": 406,
  "paths": {
    "/v1/health": {
      "get": {
        "operationId": "health",
        "summary": "bluefin health and source count.",
        "tags": [
          "discovery"
        ],
        "x-bluefin-domain": null,
        "x-bluefin-subject-kind": null,
        "x-bluefin-maturity": null,
        "x-bluefin-authority": null,
        "x-bluefin-sources": [],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/endpoints": {
      "get": {
        "operationId": "endpoints",
        "summary": "Public bluefin route catalog.",
        "tags": [
          "discovery"
        ],
        "x-bluefin-domain": null,
        "x-bluefin-subject-kind": null,
        "x-bluefin-maturity": null,
        "x-bluefin-authority": null,
        "x-bluefin-sources": [],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/sources": {
      "get": {
        "operationId": "sources",
        "summary": "Source registry and support status.",
        "tags": [
          "discovery"
        ],
        "x-bluefin-domain": null,
        "x-bluefin-subject-kind": null,
        "x-bluefin-maturity": null,
        "x-bluefin-authority": null,
        "x-bluefin-sources": [],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/catalog/sources": {
      "get": {
        "operationId": "catalog_sources",
        "summary": "Source registry and support status.",
        "tags": [
          "discovery"
        ],
        "x-bluefin-domain": null,
        "x-bluefin-subject-kind": null,
        "x-bluefin-maturity": null,
        "x-bluefin-authority": null,
        "x-bluefin-sources": [],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/catalog/capabilities": {
      "get": {
        "operationId": "catalog_capabilities",
        "summary": "Canonical bluefin capability catalog.",
        "tags": [
          "discovery"
        ],
        "x-bluefin-domain": null,
        "x-bluefin-subject-kind": null,
        "x-bluefin-maturity": null,
        "x-bluefin-authority": null,
        "x-bluefin-sources": [],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/catalog/datasets": {
      "get": {
        "operationId": "catalog_datasets",
        "summary": "Dataset-style bluefin capability catalog.",
        "tags": [
          "discovery"
        ],
        "x-bluefin-domain": null,
        "x-bluefin-subject-kind": null,
        "x-bluefin-maturity": null,
        "x-bluefin-authority": null,
        "x-bluefin-sources": [],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/catalog/fields": {
      "get": {
        "operationId": "catalog_fields",
        "summary": "Canonical domain, subject, maturity, and authority vocabularies.",
        "tags": [
          "discovery"
        ],
        "x-bluefin-domain": null,
        "x-bluefin-subject-kind": null,
        "x-bluefin-maturity": null,
        "x-bluefin-authority": null,
        "x-bluefin-sources": [],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/source-health": {
      "get": {
        "operationId": "source_health",
        "summary": "Recent per-route/per-source health records used by bluefin default source policy.",
        "tags": [
          "discovery"
        ],
        "x-bluefin-domain": null,
        "x-bluefin-subject-kind": null,
        "x-bluefin-maturity": null,
        "x-bluefin-authority": null,
        "x-bluefin-sources": [],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/coverage": {
      "get": {
        "operationId": "coverage",
        "summary": "Coverage counts by source and composite route.",
        "tags": [
          "discovery"
        ],
        "x-bluefin-domain": null,
        "x-bluefin-subject-kind": null,
        "x-bluefin-maturity": null,
        "x-bluefin-authority": null,
        "x-bluefin-sources": [],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/openapi.json": {
      "get": {
        "operationId": "openapi",
        "summary": "OpenAPI 3.1 schema.",
        "tags": [
          "discovery"
        ],
        "x-bluefin-domain": null,
        "x-bluefin-subject-kind": null,
        "x-bluefin-maturity": null,
        "x-bluefin-authority": null,
        "x-bluefin-sources": [],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/quote": {
      "get": {
        "operationId": "quote",
        "summary": "Intent-first quote observation bundle. Bluefin chooses relevant sources by default; debug_sources=... is an advanced source fanout override.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "quote_snapshot",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L3",
        "x-bluefin-authority": "portal_comparison",
        "x-bluefin-sources": [
          "yfin",
          "cfin",
          "bfin",
          "stfin",
          "sfin",
          "nfin",
          "gfin",
          "nyfin",
          "cbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/quote/{symbol}": {
      "get": {
        "operationId": "quote_alternate_1",
        "summary": "Intent-first quote observation bundle. Bluefin chooses relevant sources by default; debug_sources=... is an advanced source fanout override.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "quote_snapshot",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L3",
        "x-bluefin-authority": "portal_comparison",
        "x-bluefin-sources": [
          "yfin",
          "cfin",
          "bfin",
          "stfin",
          "sfin",
          "nfin",
          "gfin",
          "nyfin",
          "cbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}/quote": {
      "get": {
        "operationId": "quote_alternate_2",
        "summary": "Intent-first quote observation bundle. Bluefin chooses relevant sources by default; debug_sources=... is an advanced source fanout override.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "quote_snapshot",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L3",
        "x-bluefin-authority": "portal_comparison",
        "x-bluefin-sources": [
          "yfin",
          "cfin",
          "bfin",
          "stfin",
          "sfin",
          "nfin",
          "gfin",
          "nyfin",
          "cbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/search": {
      "get": {
        "operationId": "search",
        "summary": "Multi-source symbol, instrument, issuer, and content search.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "identity_search",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "gfin",
          "nfin",
          "tvfin",
          "cfin",
          "sfin",
          "stfin",
          "nyfin",
          "ofin",
          "ifin",
          "cmcfin",
          "wszfin",
          "mbfin",
          "msfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/search": {
      "get": {
        "operationId": "search_alternate_1",
        "summary": "Multi-source symbol, instrument, issuer, and content search.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "identity_search",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "gfin",
          "nfin",
          "tvfin",
          "cfin",
          "sfin",
          "stfin",
          "nyfin",
          "ofin",
          "ifin",
          "cmcfin",
          "wszfin",
          "mbfin",
          "msfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/autocomplete": {
      "get": {
        "operationId": "autocomplete",
        "summary": "Autocomplete and lightweight symbol lookup across searchable sources.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "identity_search",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "sfin",
          "stfin",
          "cmcfin",
          "mbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/resolve/{symbol}": {
      "get": {
        "operationId": "resolve",
        "summary": "Resolve a symbol-like input to source observations about the instrument identity.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "identity_search",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "nfin",
          "gfin",
          "cfin",
          "nyfin",
          "ofin",
          "ifin",
          "cmcfin",
          "wszfin",
          "msfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}": {
      "get": {
        "operationId": "resolve_alternate_1",
        "summary": "Resolve a symbol-like input to source observations about the instrument identity.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "identity_search",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "nfin",
          "gfin",
          "cfin",
          "nyfin",
          "ofin",
          "ifin",
          "cmcfin",
          "wszfin",
          "msfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}/related": {
      "get": {
        "operationId": "related",
        "summary": "Related symbols, peers, and source-defined comparable entities.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "identity_search",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "gfin",
          "cfin",
          "sifin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}/insights": {
      "get": {
        "operationId": "insights",
        "summary": "Source-defined insight, sentiment, and pricing-momentum observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "gfin",
          "cfin",
          "sifin",
          "ewfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}/summary": {
      "get": {
        "operationId": "quote_summary",
        "summary": "Detailed quote summaries and quote-adjacent instrument snapshots.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "quote_snapshot",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "nfin",
          "gfin",
          "yfin",
          "sifin",
          "scfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}/details": {
      "get": {
        "operationId": "quote_details",
        "summary": "Quote details, issue profile rows, and source-defined entity details.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "quote_snapshot",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "gfin",
          "nfin",
          "cfin",
          "stfin",
          "sifin",
          "scfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}/range": {
      "get": {
        "operationId": "quote_range",
        "summary": "Source-defined trading range and quote range observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "quote_snapshot",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "cfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}/spark": {
      "get": {
        "operationId": "quote_spark",
        "summary": "Compact sparkline-style price series.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "price_history",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}/intraday": {
      "get": {
        "operationId": "quote_intraday",
        "summary": "Intraday price observations from chart-capable sources.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "price_history",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "bfin",
          "cbfin",
          "gfin",
          "cfin",
          "stfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}/extended-hours": {
      "get": {
        "operationId": "quote_extended_hours",
        "summary": "Extended-hours and realtime-trade observations when available.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "quote_snapshot",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "nfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/history": {
      "get": {
        "operationId": "history",
        "summary": "Multi-source historical price/chart observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "price_history",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "bfin",
          "nfin",
          "gfin",
          "sfin",
          "stfin",
          "cbfin",
          "ewfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/history/{symbol}": {
      "get": {
        "operationId": "history_alternate_1",
        "summary": "Multi-source historical price/chart observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "price_history",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "bfin",
          "nfin",
          "gfin",
          "sfin",
          "stfin",
          "cbfin",
          "ewfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}/history": {
      "get": {
        "operationId": "history_alternate_2",
        "summary": "Multi-source historical price/chart observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "price_history",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "bfin",
          "nfin",
          "gfin",
          "sfin",
          "stfin",
          "cbfin",
          "ewfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}/historical-volatility": {
      "get": {
        "operationId": "historical_volatility",
        "summary": "Historical volatility series and related volatility observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "price_history",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "bfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/compare/returns": {
      "get": {
        "operationId": "compare_returns",
        "summary": "Pre-computed period returns and CAGR metrics for symbol sets.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "price_history",
        "x-bluefin-subject-kind": "instrument_set",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "sfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/compare/chart": {
      "get": {
        "operationId": "compare_chart",
        "summary": "Pre-computed multi-symbol total-return chart overlays.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "price_history",
        "x-bluefin-subject-kind": "instrument_set",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "sfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/options": {
      "get": {
        "operationId": "options",
        "summary": "Multi-source options chain, IV, Greeks, and flow observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "options_derivatives",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "cfin",
          "bfin",
          "nfin",
          "tvfin",
          "cbfin",
          "occfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/options/{symbol}": {
      "get": {
        "operationId": "options_alternate_1",
        "summary": "Multi-source options chain, IV, Greeks, and flow observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "options_derivatives",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "cfin",
          "bfin",
          "nfin",
          "tvfin",
          "cbfin",
          "occfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}/options": {
      "get": {
        "operationId": "options_alternate_2",
        "summary": "Multi-source options chain, IV, Greeks, and flow observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "options_derivatives",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "cfin",
          "bfin",
          "nfin",
          "tvfin",
          "cbfin",
          "occfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/options/{symbol}/chain": {
      "get": {
        "operationId": "option_chain",
        "summary": "Full option chains from chain-capable sources.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "options_derivatives",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "nfin",
          "bfin",
          "tvfin",
          "cbfin",
          "occfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/options/{symbol}/summary": {
      "get": {
        "operationId": "option_summary",
        "summary": "Compact option summaries and source-defined option overview data.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "options_derivatives",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "bfin",
          "cfin",
          "nfin",
          "occfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/options/{symbol}/greeks": {
      "get": {
        "operationId": "option_greeks",
        "summary": "Greeks and greek-adjacent option observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "options_derivatives",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "nfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/options/{symbol}/iv": {
      "get": {
        "operationId": "option_iv",
        "summary": "Implied-volatility and underlying aggregate observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "options_derivatives",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "tvfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/options/{symbol}/expirations": {
      "get": {
        "operationId": "option_expirations",
        "summary": "Available option expiration dates by underlying.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "options_derivatives",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "bfin",
          "occfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/options/{symbol}/historical": {
      "get": {
        "operationId": "option_historical",
        "summary": "Historical option-chain snapshots by underlying.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "options_derivatives",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "bfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/options/{symbol}/delta": {
      "get": {
        "operationId": "option_delta",
        "summary": "Delta-bucketed option summaries.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "options_derivatives",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "bfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/options/flow": {
      "get": {
        "operationId": "options_flow",
        "summary": "Unusual options activity and order-flow observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "options_derivatives",
        "x-bluefin-subject-kind": "market",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "bfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/options/most-active": {
      "get": {
        "operationId": "options_most_active",
        "summary": "Market-wide most-active options observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "options_derivatives",
        "x-bluefin-subject-kind": "market",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "cbfin",
          "bfin",
          "occfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/options/{symbol}/most-active": {
      "get": {
        "operationId": "option_most_active_by_symbol",
        "summary": "Most-active option observations scoped to an underlying where available.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "options_derivatives",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "nfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/options/strategies/{strategy}": {
      "get": {
        "operationId": "option_strategy",
        "summary": "Source-defined option strategy screens such as covered calls and naked puts.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "options_derivatives",
        "x-bluefin-subject-kind": "market",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "bfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/strategies/{strategy}": {
      "get": {
        "operationId": "option_strategy_alternate_1",
        "summary": "Source-defined option strategy screens such as covered calls and naked puts.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "options_derivatives",
        "x-bluefin-subject-kind": "market",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "bfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/strategies/top": {
      "get": {
        "operationId": "strategies_top",
        "summary": "Top trading strategy ideas across the market.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "market",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "bfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/options/strategies/chart": {
      "get": {
        "operationId": "option_strategy_chart",
        "summary": "TradingView option strategy chart data.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "options_derivatives",
        "x-bluefin-subject-kind": "market",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "tvfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/options/market-share": {
      "get": {
        "operationId": "options_market_share",
        "summary": "Cboe US options market-share statistics.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "options_derivatives",
        "x-bluefin-subject-kind": "venue",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "venue_native",
        "x-bluefin-sources": [
          "cbfin",
          "occfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/profile": {
      "get": {
        "operationId": "profile",
        "summary": "Multi-source company/fund profile and fundamentals observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "cfin",
          "nfin",
          "gfin",
          "stfin",
          "etffin",
          "sifin",
          "scfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/profile/{symbol}": {
      "get": {
        "operationId": "profile_alternate_1",
        "summary": "Multi-source company/fund profile and fundamentals observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "cfin",
          "nfin",
          "gfin",
          "stfin",
          "etffin",
          "sifin",
          "scfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}/profile": {
      "get": {
        "operationId": "profile_alternate_2",
        "summary": "Multi-source company/fund profile and fundamentals observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "cfin",
          "nfin",
          "gfin",
          "stfin",
          "etffin",
          "sifin",
          "scfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/fundamentals/{symbol}": {
      "get": {
        "operationId": "fundamentals",
        "summary": "Source-defined fundamental metrics and fundamentals snapshots.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "sfin",
          "stfin",
          "sifin",
          "msfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}/fundamentals": {
      "get": {
        "operationId": "fundamentals_alternate_1",
        "summary": "Source-defined fundamental metrics and fundamentals snapshots.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "sfin",
          "stfin",
          "sifin",
          "msfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/financials/{symbol}": {
      "get": {
        "operationId": "financials",
        "summary": "Financial statement observations across statement-capable sources.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "gfin",
          "cfin",
          "stfin",
          "ofin",
          "msfin",
          "cmcfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}/financials": {
      "get": {
        "operationId": "financials_alternate_1",
        "summary": "Financial statement observations across statement-capable sources.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "gfin",
          "cfin",
          "stfin",
          "ofin",
          "msfin",
          "cmcfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/financials/{symbol}/statements": {
      "get": {
        "operationId": "financial_statements",
        "summary": "Normalized annual financial statement facts with source-level provenance.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "issuer_disclosure",
        "x-bluefin-sources": [
          "gfin",
          "ofin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}/statements": {
      "get": {
        "operationId": "financial_statements_alternate_1",
        "summary": "Normalized annual financial statement facts with source-level provenance.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "issuer_disclosure",
        "x-bluefin-sources": [
          "gfin",
          "ofin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/financials/{symbol}/income-statement": {
      "get": {
        "operationId": "income_statement",
        "summary": "Income-statement observations where statement-specific data is available.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "issuer_disclosure",
        "x-bluefin-sources": [
          "ofin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/financials/{symbol}/balance-sheet": {
      "get": {
        "operationId": "balance_sheet",
        "summary": "Balance-sheet observations where statement-specific data is available.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "issuer_disclosure",
        "x-bluefin-sources": [
          "ofin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/financials/{symbol}/cash-flow": {
      "get": {
        "operationId": "cash_flow",
        "summary": "Cash-flow statement observations where statement-specific data is available.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "issuer_disclosure",
        "x-bluefin-sources": [
          "ofin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/analysis/revenue-epochs": {
      "get": {
        "operationId": "revenue_epochs",
        "summary": "Segment annual revenue history into growth epochs using normalized statement facts.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "issuer_disclosure",
        "x-bluefin-sources": [
          "gfin",
          "ofin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/analysis/revenue-epochs/{symbol}": {
      "get": {
        "operationId": "revenue_epochs_alternate_1",
        "summary": "Segment annual revenue history into growth epochs using normalized statement facts.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "issuer_disclosure",
        "x-bluefin-sources": [
          "gfin",
          "ofin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/analysis/event-reaction": {
      "get": {
        "operationId": "event_reaction",
        "summary": "Faux backtest of post-event close-to-close price reactions using normalized event dates and daily bars.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "corporate_actions_calendars",
        "x-bluefin-subject-kind": "event",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "sfin",
          "cfin",
          "gfin",
          "yfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/analysis/event-reaction/{symbol}": {
      "get": {
        "operationId": "event_reaction_alternate_1",
        "summary": "Faux backtest of post-event close-to-close price reactions using normalized event dates and daily bars.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "corporate_actions_calendars",
        "x-bluefin-subject-kind": "event",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "sfin",
          "cfin",
          "gfin",
          "yfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/metrics/{symbol}/valuation": {
      "get": {
        "operationId": "valuation_metrics",
        "summary": "Valuation and profitability metrics with source-specific definitions preserved.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "stfin",
          "cfin",
          "cmcfin",
          "msfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/metrics/{symbol}/market": {
      "get": {
        "operationId": "market_metrics",
        "summary": "Market snapshot metrics, key stats, and source-defined market ratio observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "cfin",
          "sifin",
          "cmcfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/earnings/{symbol}": {
      "get": {
        "operationId": "earnings",
        "summary": "Earnings history, earnings trends, EPS, and source-defined earnings observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "corporate_actions_calendars",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "gfin",
          "cfin",
          "sfin",
          "nfin",
          "stfin",
          "sifin",
          "ewfin",
          "mbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}/earnings": {
      "get": {
        "operationId": "earnings_alternate_1",
        "summary": "Earnings history, earnings trends, EPS, and source-defined earnings observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "corporate_actions_calendars",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "gfin",
          "cfin",
          "sfin",
          "nfin",
          "stfin",
          "sifin",
          "ewfin",
          "mbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/estimates": {
      "get": {
        "operationId": "estimates",
        "summary": "Consensus estimate series and estimate observations keyed by provider identifiers.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "ewfin",
          "mbfin",
          "msfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/transcripts/{id}": {
      "get": {
        "operationId": "transcripts",
        "summary": "Earnings-call transcript payloads, speakers, segments, and transcript link catalogs.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "news_content",
        "x-bluefin-subject-kind": "event",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "content_source",
        "x-bluefin-sources": [
          "ecfin",
          "msfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/earnings/transcripts/{id}": {
      "get": {
        "operationId": "transcripts_alternate_1",
        "summary": "Earnings-call transcript payloads, speakers, segments, and transcript link catalogs.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "news_content",
        "x-bluefin-subject-kind": "event",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "content_source",
        "x-bluefin-sources": [
          "ecfin",
          "msfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/transcripts": {
      "get": {
        "operationId": "transcripts_alternate_2",
        "summary": "Earnings-call transcript payloads, speakers, segments, and transcript link catalogs.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "news_content",
        "x-bluefin-subject-kind": "event",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "content_source",
        "x-bluefin-sources": [
          "ecfin",
          "msfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/ratings/{symbol}": {
      "get": {
        "operationId": "ratings",
        "summary": "Analyst ratings, sentiment, and rating-adjacent observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "gfin",
          "ewfin",
          "mbfin",
          "msfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}/ratings": {
      "get": {
        "operationId": "ratings_alternate_1",
        "summary": "Analyst ratings, sentiment, and rating-adjacent observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "gfin",
          "ewfin",
          "mbfin",
          "msfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/ownership/{symbol}": {
      "get": {
        "operationId": "ownership",
        "summary": "Ownership, shares, holders, and insider ownership observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "nfin",
          "stfin",
          "ofin",
          "msfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}/ownership": {
      "get": {
        "operationId": "ownership_alternate_1",
        "summary": "Ownership, shares, holders, and insider ownership observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "nfin",
          "stfin",
          "ofin",
          "msfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/insiders/{symbol}": {
      "get": {
        "operationId": "insiders",
        "summary": "Insider transaction and insider-summary observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "ofin",
          "oifin",
          "sifin",
          "mbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}/insiders": {
      "get": {
        "operationId": "insiders_alternate_1",
        "summary": "Insider transaction and insider-summary observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "ofin",
          "oifin",
          "sifin",
          "mbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/insider-trades": {
      "get": {
        "operationId": "insider_trades",
        "summary": "Market-wide insider trade reports.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "market",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "bfin",
          "oifin",
          "ifin",
          "mbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/congress/trades": {
      "get": {
        "operationId": "congress_trades",
        "summary": "US congressional trading disclosures and aggregate political-trading observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "portal_derived",
        "x-bluefin-sources": [
          "ifin",
          "mbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/political/trades": {
      "get": {
        "operationId": "congress_trades_alternate_1",
        "summary": "US congressional trading disclosures and aggregate political-trading observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "portal_derived",
        "x-bluefin-sources": [
          "ifin",
          "mbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/peers/{symbol}": {
      "get": {
        "operationId": "peers",
        "summary": "Peer/comparable entity observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "identity_search",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "cfin",
          "gfin",
          "yfin",
          "sifin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}/peers": {
      "get": {
        "operationId": "peers_alternate_1",
        "summary": "Peer/comparable entity observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "identity_search",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "cfin",
          "gfin",
          "yfin",
          "sifin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/news": {
      "get": {
        "operationId": "news",
        "summary": "Multi-source market and symbol news observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "news_content",
        "x-bluefin-subject-kind": "news_item",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "gfin",
          "bfin",
          "tvfin",
          "sfin",
          "stfin",
          "ofin",
          "sifin",
          "ewfin",
          "wszfin",
          "mbfin",
          "msfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/news/{symbol}": {
      "get": {
        "operationId": "news_alternate_1",
        "summary": "Multi-source market and symbol news observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "news_content",
        "x-bluefin-subject-kind": "news_item",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "gfin",
          "bfin",
          "tvfin",
          "sfin",
          "stfin",
          "ofin",
          "sifin",
          "ewfin",
          "wszfin",
          "mbfin",
          "msfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}/news": {
      "get": {
        "operationId": "news_alternate_2",
        "summary": "Multi-source market and symbol news observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "news_content",
        "x-bluefin-subject-kind": "news_item",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "gfin",
          "bfin",
          "tvfin",
          "sfin",
          "stfin",
          "ofin",
          "sifin",
          "ewfin",
          "wszfin",
          "mbfin",
          "msfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/news/latest": {
      "get": {
        "operationId": "news_latest",
        "summary": "Latest market news feeds.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "news_content",
        "x-bluefin-subject-kind": "news_item",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "tvfin",
          "nfin",
          "gfin",
          "stfin",
          "sifin",
          "ewfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/news/search": {
      "get": {
        "operationId": "news_search",
        "summary": "Free-text news search across news-capable sources.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "news_content",
        "x-bluefin-subject-kind": "news_item",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "sfin",
          "nyfin",
          "gfin",
          "sifin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/news/stories": {
      "get": {
        "operationId": "news_stories",
        "summary": "Story streams and story detail feeds.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "news_content",
        "x-bluefin-subject-kind": "news_item",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "gfin",
          "bfin",
          "sfin",
          "ewfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/news/topics/{topic}": {
      "get": {
        "operationId": "news_topic",
        "summary": "Topic-specific news feeds.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "news_content",
        "x-bluefin-subject-kind": "news_item",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "nfin",
          "tvfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/news/{news_id}/content": {
      "get": {
        "operationId": "news_content",
        "summary": "News story body/content lookups by source story identifier.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "news_content",
        "x-bluefin-subject-kind": "news_item",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "ofin",
          "bfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/calendar": {
      "get": {
        "operationId": "calendar",
        "summary": "Multi-source earnings, dividend, splits, IPO, and economic calendars.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "corporate_actions_calendars",
        "x-bluefin-subject-kind": "event",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "nfin",
          "tvfin",
          "bfin",
          "cfin",
          "stfin",
          "sifin",
          "ecfin",
          "ewfin",
          "mbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/calendar/{kind}": {
      "get": {
        "operationId": "calendar_alternate_1",
        "summary": "Multi-source earnings, dividend, splits, IPO, and economic calendars.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "corporate_actions_calendars",
        "x-bluefin-subject-kind": "event",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "nfin",
          "tvfin",
          "bfin",
          "cfin",
          "stfin",
          "sifin",
          "ecfin",
          "ewfin",
          "mbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/calendar/earnings": {
      "get": {
        "operationId": "calendar_earnings",
        "summary": "Earnings calendar events.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "corporate_actions_calendars",
        "x-bluefin-subject-kind": "event",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "nfin",
          "tvfin",
          "cfin",
          "bfin",
          "sifin",
          "ecfin",
          "ewfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/calendar/dividends": {
      "get": {
        "operationId": "calendar_dividends",
        "summary": "Dividend calendar and ex-date events.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "corporate_actions_calendars",
        "x-bluefin-subject-kind": "event",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "nfin",
          "tvfin",
          "nyfin",
          "bfin",
          "mbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/calendar/splits": {
      "get": {
        "operationId": "calendar_splits",
        "summary": "Split calendar events.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "corporate_actions_calendars",
        "x-bluefin-subject-kind": "event",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "nfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/calendar/ipo": {
      "get": {
        "operationId": "calendar_ipo",
        "summary": "IPO calendar events.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "corporate_actions_calendars",
        "x-bluefin-subject-kind": "event",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "nfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/ipo/calendar": {
      "get": {
        "operationId": "calendar_ipo_alternate_1",
        "summary": "IPO calendar events.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "corporate_actions_calendars",
        "x-bluefin-subject-kind": "event",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "nfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/calendar/economic": {
      "get": {
        "operationId": "calendar_economic",
        "summary": "Economic calendar events.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "corporate_actions_calendars",
        "x-bluefin-subject-kind": "event",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "tvfin",
          "stfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/events": {
      "get": {
        "operationId": "events",
        "summary": "General market, finance, and company event feeds.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "corporate_actions_calendars",
        "x-bluefin-subject-kind": "event",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "gfin",
          "yfin",
          "stfin",
          "nfin",
          "ecfin",
          "sifin",
          "ewfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}/events": {
      "get": {
        "operationId": "instrument_events",
        "summary": "Symbol-scoped event, earnings, and calendar observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "corporate_actions_calendars",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "stfin",
          "cfin",
          "sfin",
          "ewfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/dividends/{symbol}": {
      "get": {
        "operationId": "dividends",
        "summary": "Symbol dividend history and dividend actions.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "corporate_actions_calendars",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "nfin",
          "sfin",
          "ofin",
          "sifin",
          "mbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}/dividends": {
      "get": {
        "operationId": "dividends_alternate_1",
        "summary": "Symbol dividend history and dividend actions.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "corporate_actions_calendars",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "nfin",
          "sfin",
          "ofin",
          "sifin",
          "mbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/splits/{symbol}": {
      "get": {
        "operationId": "splits",
        "summary": "Symbol split actions and split-related observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "corporate_actions_calendars",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "ofin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}/splits": {
      "get": {
        "operationId": "splits_alternate_1",
        "summary": "Symbol split actions and split-related observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "corporate_actions_calendars",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "ofin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/corporate-actions": {
      "get": {
        "operationId": "corporate_actions",
        "summary": "Corporate actions feeds and venue action calendars.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "corporate_actions_calendars",
        "x-bluefin-subject-kind": "event",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "nyfin",
          "stfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}/corporate-actions": {
      "get": {
        "operationId": "instrument_corporate_actions",
        "summary": "Symbol-scoped corporate actions.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "corporate_actions_calendars",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "bfin",
          "stfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/funds": {
      "get": {
        "operationId": "funds",
        "summary": "Fund and ETF catalogs and popular ETF lists.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fund_etf",
        "x-bluefin-subject-kind": "fund",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "etffin",
          "nyfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/funds/{symbol}/profile": {
      "get": {
        "operationId": "fund_profile",
        "summary": "ETF/fund profile observations with issuer-native data preferred.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fund_etf",
        "x-bluefin-subject-kind": "fund",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "issuer_native",
        "x-bluefin-sources": [
          "etffin",
          "yfin",
          "cfin",
          "nfin",
          "nyfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/fund/{symbol}/profile": {
      "get": {
        "operationId": "fund_profile_alternate_1",
        "summary": "ETF/fund profile observations with issuer-native data preferred.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fund_etf",
        "x-bluefin-subject-kind": "fund",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "issuer_native",
        "x-bluefin-sources": [
          "etffin",
          "yfin",
          "cfin",
          "nfin",
          "nyfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/fund/{symbol}/holdings": {
      "get": {
        "operationId": "fund_holdings",
        "summary": "Multi-source ETF/fund holdings and fund data observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fund_etf",
        "x-bluefin-subject-kind": "fund",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "issuer_native",
        "x-bluefin-sources": [
          "etffin",
          "yfin",
          "cfin",
          "nfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/funds/{symbol}/holdings": {
      "get": {
        "operationId": "fund_holdings_alternate_1",
        "summary": "Multi-source ETF/fund holdings and fund data observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fund_etf",
        "x-bluefin-subject-kind": "fund",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "issuer_native",
        "x-bluefin-sources": [
          "etffin",
          "yfin",
          "cfin",
          "nfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/funds/{symbol}/price": {
      "get": {
        "operationId": "fund_price",
        "summary": "ETF/fund price observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fund_etf",
        "x-bluefin-subject-kind": "fund",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "etffin",
          "nyfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/funds/{symbol}/history": {
      "get": {
        "operationId": "fund_history",
        "summary": "ETF/fund price-history observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fund_etf",
        "x-bluefin-subject-kind": "fund",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "etffin",
          "yfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/funds/{symbol}/performance": {
      "get": {
        "operationId": "fund_performance",
        "summary": "ETF/fund performance observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fund_etf",
        "x-bluefin-subject-kind": "fund",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "issuer_native",
        "x-bluefin-sources": [
          "etffin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/funds/{symbol}/distributions": {
      "get": {
        "operationId": "fund_distributions",
        "summary": "ETF/fund distributions observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fund_etf",
        "x-bluefin-subject-kind": "fund",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "issuer_native",
        "x-bluefin-sources": [
          "etffin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/funds/{symbol}/exposures": {
      "get": {
        "operationId": "fund_exposures",
        "summary": "ETF/fund exposure observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fund_etf",
        "x-bluefin-subject-kind": "fund",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "issuer_native",
        "x-bluefin-sources": [
          "etffin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/funds/{symbol}/premium-discount": {
      "get": {
        "operationId": "fund_premium_discount",
        "summary": "ETF premium/discount observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fund_etf",
        "x-bluefin-subject-kind": "fund",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "issuer_native",
        "x-bluefin-sources": [
          "etffin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/funds/providers": {
      "get": {
        "operationId": "fund_providers",
        "summary": "ETF issuer/provider catalogs.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fund_etf",
        "x-bluefin-subject-kind": "fund_provider",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "etffin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/funds/providers/{provider}": {
      "get": {
        "operationId": "fund_provider_funds",
        "summary": "Funds listed by ETF issuer/provider.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fund_etf",
        "x-bluefin-subject-kind": "fund_provider",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "etffin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/markets/summary": {
      "get": {
        "operationId": "markets_summary",
        "summary": "Market summary, market state, and overview observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "market",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "gfin",
          "cfin",
          "stfin",
          "nyfin",
          "nfin",
          "sifin",
          "msfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/markets/movers": {
      "get": {
        "operationId": "markets_movers",
        "summary": "Market movers, active names, advancers, decliners, and issue movers.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "market",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "nfin",
          "cfin",
          "gfin",
          "stfin",
          "ofin",
          "cbfin",
          "sifin",
          "mbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/markets/indices": {
      "get": {
        "operationId": "markets_indices",
        "summary": "Index quote, definition, and index-list observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "index",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "nfin",
          "cbfin",
          "sifin",
          "scfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/markets/sectors": {
      "get": {
        "operationId": "markets_sectors",
        "summary": "Sector, industry, and aggregation observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "market",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "sfin",
          "sifin",
          "msfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/markets/exchanges": {
      "get": {
        "operationId": "markets_exchanges",
        "summary": "Exchange, provider, market-data service, and listing-directory metadata.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "venue",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "bfin",
          "cbfin",
          "etffin",
          "sifin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/markets/fair-value": {
      "get": {
        "operationId": "markets_fair_value",
        "summary": "Fair-value observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "market",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "cfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/markets/time": {
      "get": {
        "operationId": "markets_time",
        "summary": "Market time, delayed quote server time, and source clock observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "metadata_system",
        "x-bluefin-subject-kind": "market",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "cbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/markets/group-quotes": {
      "get": {
        "operationId": "markets_group_quotes",
        "summary": "Group quote screens and source-defined group snapshots.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "market",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "stfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/trending": {
      "get": {
        "operationId": "trending",
        "summary": "Trending symbols and source-defined popular lists.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "market",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "cfin",
          "gfin",
          "sifin",
          "mbfin",
          "ewfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/listings": {
      "get": {
        "operationId": "listings",
        "summary": "Normalized exchange listing universe for active equity-like instruments. Defaults to NYSE and Nasdaq and preserves source provenance.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "instrument_set",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "venue_native",
        "x-bluefin-sources": [
          "nyfin",
          "nfin",
          "cmcfin",
          "wszfin",
          "scfin",
          "msfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/universe/equities": {
      "get": {
        "operationId": "listings_alternate_1",
        "summary": "Normalized exchange listing universe for active equity-like instruments. Defaults to NYSE and Nasdaq and preserves source provenance.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "instrument_set",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "venue_native",
        "x-bluefin-sources": [
          "nyfin",
          "nfin",
          "cmcfin",
          "wszfin",
          "scfin",
          "msfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/screener": {
      "get": {
        "operationId": "screener",
        "summary": "Screeners and scanner results. POST-native upstreams are intentionally omitted from public GET fanout.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "market",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin",
          "sfin",
          "nyfin",
          "oifin",
          "wszfin",
          "cmcfin",
          "msfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/screener/discover": {
      "get": {
        "operationId": "screener_discover",
        "summary": "Discoverable screener definitions and screen metadata.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "market",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "yfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/screener/{type}": {
      "get": {
        "operationId": "screener_type",
        "summary": "Source-defined screener by type.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "market",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "nfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/screener/fields/{field}": {
      "get": {
        "operationId": "screener_field",
        "summary": "Single-field screener output as ticker/value rows.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "market",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "sfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/regulatory": {
      "get": {
        "operationId": "regulatory",
        "summary": "Multi-source regulatory and market-structure data, preserving source-specific datasets.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "regulatory_dataset",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "rfin",
          "ofin",
          "nyfin",
          "cbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/regulatory/{view}": {
      "get": {
        "operationId": "regulatory_alternate_1",
        "summary": "Multi-source regulatory and market-structure data, preserving source-specific datasets.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "regulatory_dataset",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "rfin",
          "ofin",
          "nyfin",
          "cbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/regulatory/short-interest": {
      "get": {
        "operationId": "reg_short_interest",
        "summary": "Short-interest records from source-of-record regulatory feeds.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "regulatory_dataset",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "rfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/regulatory/short-interest/{symbol}": {
      "get": {
        "operationId": "reg_short_interest_symbol",
        "summary": "Symbol-scoped short-interest observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "nfin",
          "rfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/regulatory/short-sale": {
      "get": {
        "operationId": "reg_short_sale",
        "summary": "Short-sale volume, circuit breaker, and Reg SHO observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "regulatory_dataset",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "rfin",
          "cbfin",
          "ofin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/regulatory/reg-sho": {
      "get": {
        "operationId": "reg_reg_sho",
        "summary": "Reg SHO daily lists and source-defined Reg SHO datasets.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "regulatory_dataset",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "rfin",
          "ofin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/regulatory/threshold": {
      "get": {
        "operationId": "reg_threshold",
        "summary": "Threshold securities list observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "regulatory_dataset",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "rfin",
          "occfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/regulatory/halts": {
      "get": {
        "operationId": "reg_halts",
        "summary": "Trading halt and halt-file observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "regulatory_dataset",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "rfin",
          "cbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/regulatory/noncompliant": {
      "get": {
        "operationId": "reg_noncompliant",
        "summary": "NYSE noncompliant issuer directory.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "regulatory_dataset",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "nyfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/regulatory/noncompliant/{symbol}": {
      "get": {
        "operationId": "reg_noncompliant_symbol",
        "summary": "NYSE noncompliant issuer lookup by symbol.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "nyfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/filings": {
      "get": {
        "operationId": "filings",
        "summary": "SEC filing and disclosure feeds.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "regulatory_dataset",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "ofin",
          "nfin",
          "mbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/filings/{symbol}": {
      "get": {
        "operationId": "filings_symbol",
        "summary": "Symbol-scoped SEC filings and disclosure reports.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "ofin",
          "mbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/instruments/{symbol}/filings": {
      "get": {
        "operationId": "filings_symbol_alternate_1",
        "summary": "Symbol-scoped SEC filings and disclosure reports.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "ofin",
          "mbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/filings/{filing_id}/pdf": {
      "get": {
        "operationId": "filing_pdf",
        "summary": "SEC filing PDF document lookup.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "filing",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "ofin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/otc/securities": {
      "get": {
        "operationId": "otc_securities",
        "summary": "OTC security master and issuer lists.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "ofin",
          "rfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/otc/securities/{symbol}": {
      "get": {
        "operationId": "otc_security",
        "summary": "OTC security lookup and related issuer information.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "ofin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/otc/markets/movers": {
      "get": {
        "operationId": "otc_markets_movers",
        "summary": "OTC active, advancer, decliner, overnight, and snapshot market observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "market",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "ofin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/otc/compliance": {
      "get": {
        "operationId": "otc_compliance",
        "summary": "OTC compliance statistics across caveat, grace-period, promotion, split, shell, and suspension datasets.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "regulatory_dataset",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "ofin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/fixed-income/{dataset}/metadata": {
      "get": {
        "operationId": "fixed_income_metadata",
        "summary": "FINRA fixed-income dataset metadata.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "regulatory_dataset",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "rfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/finra/otc/{dataset}": {
      "get": {
        "operationId": "finra_otc_dataset",
        "summary": "FINRA OTC datasets by dataset slug.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "regulatory_dataset",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "rfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/finra/otc/{dataset}/metadata": {
      "get": {
        "operationId": "finra_otc_metadata",
        "summary": "FINRA OTC dataset metadata.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "regulatory_dataset",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "rfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/finra/otc/{dataset}/partitions": {
      "get": {
        "operationId": "finra_otc_partitions",
        "summary": "FINRA OTC dataset partitions.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "regulatory_dataset",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "rfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/finra/otc/{dataset}/query": {
      "get": {
        "operationId": "finra_otc_query",
        "summary": "GET-facing Bluefin query wrapper over the structured FINRA OTC dataset query endpoint.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "regulatory_dataset",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "rfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/finra/otc/daily-list": {
      "get": {
        "operationId": "finra_otc_daily_list",
        "summary": "FINRA OTC daily list events and reference updates.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "regulatory_dataset",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "rfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/venues/cboe/status": {
      "get": {
        "operationId": "venue_cboe_status",
        "summary": "Cboe system status observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "venue",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "venue_native",
        "x-bluefin-sources": [
          "cbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/venues/cboe/equities": {
      "get": {
        "operationId": "venue_cboe_equities",
        "summary": "Cboe equities statistics, market totals, top volume, and market-share observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "venue",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "venue_native",
        "x-bluefin-sources": [
          "cbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/venues/cboe/book-viewer/symbols": {
      "get": {
        "operationId": "venue_cboe_book_viewer",
        "summary": "Cboe book-viewer symbol lookup and depth metadata.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "venue",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "venue_native",
        "x-bluefin-sources": [
          "cbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/venues/cboe/options/most-active": {
      "get": {
        "operationId": "venue_cboe_options_most_active",
        "summary": "Cboe most-active options statistics.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "options_derivatives",
        "x-bluefin-subject-kind": "venue",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "venue_native",
        "x-bluefin-sources": [
          "cbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/venues/cboe/futures/quotes": {
      "get": {
        "operationId": "venue_cboe_futures_quotes",
        "summary": "Cboe futures quote/product data.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "quote_snapshot",
        "x-bluefin-subject-kind": "future_contract",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "venue_native",
        "x-bluefin-sources": [
          "cbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/venues/cboe/symbol-roots": {
      "get": {
        "operationId": "venue_cboe_symbol_roots",
        "summary": "Cboe delayed quote root and symbol master data.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "metadata_system",
        "x-bluefin-subject-kind": "source_metadata",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "venue_native",
        "x-bluefin-sources": [
          "cbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/venues/cboe/futures/settlement": {
      "get": {
        "operationId": "venue_cboe_futures_settlement",
        "summary": "Cboe futures settlement values and CSV settlement downloads.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "price_history",
        "x-bluefin-subject-kind": "future_contract",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "venue_native",
        "x-bluefin-sources": [
          "cbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/venues/cboe/fx/volume": {
      "get": {
        "operationId": "venue_cboe_fx_volume",
        "summary": "Cboe FX ADV and SEF volume statistics.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "market",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "venue_native",
        "x-bluefin-sources": [
          "cbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/venues/cboe/index-settlement/{settlement_type}/years": {
      "get": {
        "operationId": "venue_cboe_index_settlement_years",
        "summary": "Cboe index settlement available years.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "price_history",
        "x-bluefin-subject-kind": "index",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "venue_native",
        "x-bluefin-sources": [
          "cbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/venues/cboe/index-settlement/{settlement_type}/{year}": {
      "get": {
        "operationId": "venue_cboe_index_settlement_values",
        "summary": "Cboe index settlement values by settlement type and year.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "price_history",
        "x-bluefin-subject-kind": "index",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "venue_native",
        "x-bluefin-sources": [
          "cbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/venues/cboe/notices/{region}/{year}": {
      "get": {
        "operationId": "venue_cboe_notices",
        "summary": "Cboe exchange notice feeds. region supports au, ca, and europe-trf.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "venue",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "venue_native",
        "x-bluefin-sources": [
          "cbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/venues/cboe/indices/governance/consultations": {
      "get": {
        "operationId": "venue_cboe_indices_governance",
        "summary": "Cboe index governance and consultation data.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "index",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "venue_native",
        "x-bluefin-sources": [
          "cbfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/futures/cot": {
      "get": {
        "operationId": "futures_cot",
        "summary": "CFTC Commitment of Traders data packaged per futures category.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "future_contract",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "cotfin",
          "bfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/futures/hilo": {
      "get": {
        "operationId": "futures_hilo",
        "summary": "Lifetime high/low futures data.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "price_history",
        "x-bluefin-subject-kind": "future_contract",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "bfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/fx/rates": {
      "get": {
        "operationId": "fx_rates",
        "summary": "FX, crypto, and metals exchange-rate tables.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "quote_snapshot",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "sfin",
          "treasuryfin",
          "sifin",
          "scfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/research": {
      "get": {
        "operationId": "research",
        "summary": "Research and source-defined research content.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "news_content",
        "x-bluefin-subject-kind": "news_item",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "gfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/ideas": {
      "get": {
        "operationId": "ideas",
        "summary": "TradingView ideas and community analysis feeds.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "news_content",
        "x-bluefin-subject-kind": "news_item",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "tvfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/watchlists": {
      "get": {
        "operationId": "watchlists",
        "summary": "Watchlist data and watchlist-style column joins.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "instrument_set",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "gfin",
          "sfin",
          "nfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/portfolios/investing-club": {
      "get": {
        "operationId": "investing_club_portfolio",
        "summary": "CNBC Investing Club portfolio observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "instrument_set",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "cfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/home/hero-groups": {
      "get": {
        "operationId": "home_hero_groups",
        "summary": "Google Finance home hero groups.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "market",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "gfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/markets/nordic/listing": {
      "get": {
        "operationId": "nordic_listing",
        "summary": "Nasdaq Nordic listing data.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "market",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "nfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/markets/nordic/movers": {
      "get": {
        "operationId": "nordic_movers",
        "summary": "Nasdaq Nordic market movers.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "market",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "nfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/markets/nordic/search": {
      "get": {
        "operationId": "nordic_search",
        "summary": "Nasdaq Nordic search.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "identity_search",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "nfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/markets/nordic/instruments/{order_book_id}": {
      "get": {
        "operationId": "nordic_instrument",
        "summary": "Nasdaq Nordic instrument summary, info, and price-info by order book id.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "quote_snapshot",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "nfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/markets/nordic/instruments/{order_book_id}/trades": {
      "get": {
        "operationId": "nordic_instrument_trades",
        "summary": "Nasdaq Nordic instrument trades by order book id.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "quote_snapshot",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "nfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/markets/nordic/star/{order_book_id}/key-stats": {
      "get": {
        "operationId": "nordic_key_stats",
        "summary": "Nasdaq Nordic STAR key stats.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "instrument",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "nfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/markets/lists/{list_id}": {
      "get": {
        "operationId": "nasdaq_market_list",
        "summary": "Nasdaq market list by list id.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "market",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "nfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/ipo": {
      "get": {
        "operationId": "ipo",
        "summary": "IPO overview, experts, calendar, and filing observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "corporate_actions_calendars",
        "x-bluefin-subject-kind": "event",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "nfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/options/isee": {
      "get": {
        "operationId": "isee",
        "summary": "Nasdaq ISEE option sentiment observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "options_derivatives",
        "x-bluefin-subject-kind": "market",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "nfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/scanner/{market}/scan": {
      "get": {
        "operationId": "tv_scanner",
        "summary": "TradingView scanner data and scanner metadata by market.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "market",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "tvfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/scanner/global": {
      "get": {
        "operationId": "tv_global_scanner",
        "summary": "TradingView global scanner.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "market",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "tvfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/price-alerts/status": {
      "get": {
        "operationId": "price_alerts_status",
        "summary": "TradingView price-alert service status.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "metadata_system",
        "x-bluefin-subject-kind": "source_metadata",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "tvfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/scripts": {
      "get": {
        "operationId": "scripts",
        "summary": "TradingView script catalogs.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "metadata_system",
        "x-bluefin-subject-kind": "source_metadata",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "tvfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/pine/builtins": {
      "get": {
        "operationId": "pine_builtins",
        "summary": "TradingView Pine builtins metadata.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "metadata_system",
        "x-bluefin-subject-kind": "source_metadata",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "tvfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/pine/list": {
      "get": {
        "operationId": "pine_list",
        "summary": "TradingView Pine script list metadata.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "metadata_system",
        "x-bluefin-subject-kind": "source_metadata",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "tvfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/pine/parse-title": {
      "get": {
        "operationId": "pine_parse_title",
        "summary": "TradingView Pine title parsing metadata.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "metadata_system",
        "x-bluefin-subject-kind": "source_metadata",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "tvfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/pine/translate-source/{version}": {
      "get": {
        "operationId": "pine_translate_source",
        "summary": "TradingView Pine source translation metadata.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "metadata_system",
        "x-bluefin-subject-kind": "source_metadata",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "tvfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/rss": {
      "get": {
        "operationId": "rss",
        "summary": "RSS-style market feed observations.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "news_content",
        "x-bluefin-subject-kind": "news_item",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "stfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/constituents": {
      "get": {
        "operationId": "constituents",
        "summary": "Index, group, or source-defined constituent lists.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "instrument_set",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "mixed",
        "x-bluefin-sources": [
          "stfin",
          "scfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/datasets/occ/volume/daily": {
      "get": {
        "operationId": "dataset_occ_volume_daily",
        "summary": "OCC daily cleared contract volume dataset.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "options_derivatives",
        "x-bluefin-subject-kind": "regulatory_dataset",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "occfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/datasets/occ/open-interest/daily": {
      "get": {
        "operationId": "dataset_occ_open_interest_daily",
        "summary": "OCC daily open-interest dataset.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "options_derivatives",
        "x-bluefin-subject-kind": "regulatory_dataset",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "occfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/datasets/occ/options/series/{symbol}": {
      "get": {
        "operationId": "dataset_occ_options_series",
        "summary": "OCC option series by underlying.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "options_derivatives",
        "x-bluefin-subject-kind": "option_contract",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "occfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/datasets/occ/options/deliverables": {
      "get": {
        "operationId": "dataset_occ_options_deliverables",
        "summary": "OCC equity option deliverables dataset.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "options_derivatives",
        "x-bluefin-subject-kind": "regulatory_dataset",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "occfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/datasets/cftc/cot/{family}": {
      "get": {
        "operationId": "dataset_cftc_cot_reports",
        "summary": "CFTC Commitments of Traders report family dataset.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "future_contract",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "cotfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/datasets/cftc/cot/report-families": {
      "get": {
        "operationId": "dataset_cftc_cot_report_families",
        "summary": "CFTC COT report family catalog.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "regulatory_dataset",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "cotfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/datasets/cftc/cot/product-hierarchy": {
      "get": {
        "operationId": "dataset_cftc_cot_product_hierarchy",
        "summary": "CFTC COT product hierarchy.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "regulatory_dataset",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "cotfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/datasets/treasury/auctions": {
      "get": {
        "operationId": "dataset_treasury_auctions",
        "summary": "Treasury auction results and announcements.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "regulatory_dataset",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "treasuryfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/datasets/treasury/debt/daily": {
      "get": {
        "operationId": "dataset_treasury_debt_daily",
        "summary": "Treasury daily public debt outstanding.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "regulatory_dataset",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "treasuryfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/datasets/treasury/interest-expense": {
      "get": {
        "operationId": "dataset_treasury_interest_expense",
        "summary": "Treasury interest expense on public debt outstanding.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "regulatory_dataset",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "treasuryfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/datasets/companies-market-cap/rankings/{ranking_path}": {
      "get": {
        "operationId": "dataset_companies_market_cap_rankings",
        "summary": "CompaniesMarketCap ranking dataset by ranking path.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "instrument_set",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "portal_derived",
        "x-bluefin-sources": [
          "cmcfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/datasets/openinsider/screener": {
      "get": {
        "operationId": "dataset_openinsider_screener",
        "summary": "OpenInsider screener dataset.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "filing_aggregator",
        "x-bluefin-sources": [
          "oifin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/datasets/slickcharts/index/{index}/constituents": {
      "get": {
        "operationId": "dataset_slickcharts_index_constituents",
        "summary": "Slickcharts index constituents and weights.",
        "tags": [
          "composite"
        ],
        "x-bluefin-domain": "market_lists_screeners",
        "x-bluefin-subject-kind": "instrument_set",
        "x-bluefin-maturity": "L1",
        "x-bluefin-authority": "portal_derived",
        "x-bluefin-sources": [
          "scfin"
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/entities/resolve": {
      "get": {
        "operationId": "entities_resolve",
        "summary": "Resolve an entity, instrument, bank, or legal-entity query into durable Bluefin candidates.",
        "tags": [
          "official_composite"
        ],
        "x-bluefin-domain": "identity_search",
        "x-bluefin-subject-kind": "entity",
        "x-bluefin-maturity": "L3",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "sec",
          "nasdaq_trader",
          "openfigi",
          "gleif",
          "yfin",
          "gfin",
          "nfin"
        ],
        "responses": {
          "200": {
            "description": "Successful Bluefin evidence response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/identifiers/map": {
      "get": {
        "operationId": "identifiers_map",
        "summary": "Map identifiers such as ticker, CIK, FIGI, ISIN, CUSIP, LEI, or FDIC CERT.",
        "tags": [
          "official_composite"
        ],
        "x-bluefin-domain": "identity_search",
        "x-bluefin-subject-kind": "identifier",
        "x-bluefin-maturity": "L3",
        "x-bluefin-authority": "identifier_registry",
        "x-bluefin-sources": [
          "sec",
          "openfigi",
          "gleif"
        ],
        "responses": {
          "200": {
            "description": "Successful Bluefin evidence response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/entities/{entity_id}": {
      "get": {
        "operationId": "entity_profile",
        "summary": "Fetch an official entity profile by durable Bluefin ID.",
        "tags": [
          "official_composite"
        ],
        "x-bluefin-domain": "identity_search",
        "x-bluefin-subject-kind": "entity",
        "x-bluefin-maturity": "L3",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "sec",
          "gleif"
        ],
        "responses": {
          "200": {
            "description": "Successful Bluefin evidence response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/entities/{entity_id}/facts": {
      "get": {
        "operationId": "entity_facts",
        "summary": "Fetch official SEC XBRL company facts for a CIK-backed entity.",
        "tags": [
          "official_composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "issuer",
        "x-bluefin-maturity": "L3",
        "x-bluefin-authority": "issuer_disclosure",
        "x-bluefin-sources": [
          "sec"
        ],
        "responses": {
          "200": {
            "description": "Successful Bluefin evidence response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/entities/{entity_id}/filings": {
      "get": {
        "operationId": "entity_filings",
        "summary": "Fetch recent official SEC filings for a CIK-backed entity.",
        "tags": [
          "official_composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "filing",
        "x-bluefin-maturity": "L3",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "sec"
        ],
        "responses": {
          "200": {
            "description": "Successful Bluefin evidence response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/entities/{entity_id}/public-records": {
      "get": {
        "operationId": "entity_public_records",
        "summary": "Fetch public-record mentions and filings for a named entity.",
        "tags": [
          "official_composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "public_record",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "sec",
          "gleif",
          "lda",
          "federal_register"
        ],
        "responses": {
          "200": {
            "description": "Successful Bluefin evidence response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/public-records": {
      "get": {
        "operationId": "public_records_search",
        "summary": "Search public-record mentions and filings by entity name.",
        "tags": [
          "official_composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "public_record",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "lda",
          "federal_register"
        ],
        "responses": {
          "200": {
            "description": "Successful Bluefin evidence response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/listings/{mic}/{symbol}": {
      "get": {
        "operationId": "listings_lookup",
        "summary": "Resolve a venue listing using MIC plus symbol.",
        "tags": [
          "official_composite"
        ],
        "x-bluefin-domain": "identity_search",
        "x-bluefin-subject-kind": "listing",
        "x-bluefin-maturity": "L3",
        "x-bluefin-authority": "venue_native",
        "x-bluefin-sources": [
          "nasdaq_trader",
          "sec",
          "openfigi"
        ],
        "responses": {
          "200": {
            "description": "Successful Bluefin evidence response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/banks/resolve": {
      "get": {
        "operationId": "banks_resolve",
        "summary": "Resolve banks by name, state, or FDIC certificate.",
        "tags": [
          "official_composite"
        ],
        "x-bluefin-domain": "identity_search",
        "x-bluefin-subject-kind": "bank_institution",
        "x-bluefin-maturity": "L3",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "fdic"
        ],
        "responses": {
          "200": {
            "description": "Successful Bluefin evidence response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/banks/{fdic_cert}": {
      "get": {
        "operationId": "bank_profile",
        "summary": "Fetch FDIC institution identity and latest call-report financials.",
        "tags": [
          "official_composite"
        ],
        "x-bluefin-domain": "fundamentals",
        "x-bluefin-subject-kind": "bank_institution",
        "x-bluefin-maturity": "L3",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "fdic"
        ],
        "responses": {
          "200": {
            "description": "Successful Bluefin evidence response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/macro/series": {
      "get": {
        "operationId": "macro_series",
        "summary": "Fetch an official macro time series by source and series ID.",
        "tags": [
          "official_composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "macro_series",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "fred"
        ],
        "responses": {
          "200": {
            "description": "Successful Bluefin evidence response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/v1/macro/series/{series_id}": {
      "get": {
        "operationId": "macro_series_by_id",
        "summary": "Fetch an official macro time series by series ID.",
        "tags": [
          "official_composite"
        ],
        "x-bluefin-domain": "regulatory_market_structure",
        "x-bluefin-subject-kind": "macro_series",
        "x-bluefin-maturity": "L2",
        "x-bluefin-authority": "source_of_record",
        "x-bluefin-sources": [
          "fred"
        ],
        "responses": {
          "200": {
            "description": "Successful Bluefin evidence response.",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    }
  },
  "x-bluefin-official-source-count": 8,
  "x-bluefin-mvp-route-count": 12
}