Alphanume De Spac Events API

openapi: 3.2.0
info:
  contact:
    url: https://alphanume.com
  description: 'Point-in-time, survivorship-aware datasets for US equities and options research. Every response is JSON: {"count": N, "data": [...]} (paginated endpoints add has_more and next_cursor). Dates are always YYYY-MM-DD. Access: every dataset requires an Alphanume Pro API key (the Free plan is retired as of September 6, 2026). A 403 error with code PRO_SUBSCRIPTION_REQUIRED or DATE_RANGE_RESTRICTED means the key''s plan does not cover the request -- it does not mean the data is missing. Authentication: send your API key in the X-API-Key header (or Authorization: Bearer). Rate limit: 600 requests/minute. Keys come with a Pro subscription at https://alphanume.com/pricing. The same datasets are available as MCP tools at https://mcp.alphanume.com/mcp.'
  title: Alphanume De Spac Events API
  version: 1.1.0
servers:
- url: https://api.alphanume.com
security:
- ApiKeyHeader: []
- BearerKey: []
tags:
- name: De Spac Events
paths:
  /v1/de-spac-events:
    get:
      description: 'De-SPAC lifecycle: one row per SPAC business combination tracked from the

        definitive-agreement announcement through registration, definitive proxy, shareholder

        vote, exchange listing and completion (or termination / trust liquidation). Every row

        carries the SPAC''s own symbol (prior_ticker), the combined company''s symbol as soon as a

        filing names it (new_ticker -- the definitive proxy does so in most deals, weeks before

        the close), warrant ticker, exchange, SPAC / target / new company names, and the dated

        milestones: announced_date, meeting_date, record_date, vote_approved_date,

        listing_filed_date, expected_close_date and expected_trading_date (each with a *_basis

        column saying whether the date was stated in a filing or derived), closing_date,

        trading_commencement_date, terminated_date, plus next_event_date / next_event_type for

        what comes next. Completed rows also carry the closing financials (redemption shares and

        dollars, trust remaining, PIPE, gross proceeds, pro forma shares, enterprise and equity

        value), a confidence score and the supporting evidence quote. `date` is the SEC filing

        date of the filing that set the row''s current status (for completed deals: the closing

        8-K). `ticker` is the symbol trading for the deal today (new_ticker once listing is

        pending, otherwise prior_ticker). Fields are null where no filing supported them;

        quality_flags lists any rule that altered or withheld a value.


        Use status=pending&upcoming=true to see de-SPACs before the new symbol trades,

        ticker= to follow one deal, view=history to replay what was known on a

        given date, or status=completed with a date range for the classic redemption-rate

        event study.


        Requires an Alphanume Pro API key. A 403 PRO_SUBSCRIPTION_REQUIRED or

        DATE_RANGE_RESTRICTED error means the key''s plan does not cover the request --

        it does not mean the data is missing.'
      operationId: get_de_spac_events
      parameters:
      - description: Exact date, YYYY-MM-DD. Cannot be combined with the date range parameters.
        in: query
        name: date
        required: false
        schema:
          type: string
      - description: Start of date range, inclusive (YYYY-MM-DD).
        in: query
        name: date_gte
        required: false
        schema:
          type: string
      - description: End of date range, inclusive (YYYY-MM-DD).
        in: query
        name: date_lte
        required: false
        schema:
          type: string
      - description: Start of date range, exclusive (YYYY-MM-DD).
        in: query
        name: date_gt
        required: false
        schema:
          type: string
      - description: End of date range, exclusive (YYYY-MM-DD).
        in: query
        name: date_lt
        required: false
        schema:
          type: string
      - description: 'Comma-separated deal statuses to return: announced, registration_filed, registration_effective, vote_scheduled, approved, listing_pending, completed, terminated, liquidated; or the shorthands ''all'' (default) and ''pending'' (every non-terminal status). Unknown values return a 400 listing the valid ones.'
        in: query
        name: status
        required: false
        schema:
          type: string
      - description: Symbol filter matched against BOTH the SPAC's own symbol (prior_ticker) and the post-combination symbol (new_ticker), so either side of the rename works.
        in: query
        name: ticker
        required: false
        schema:
          type: string
      - description: '''true'' = only pending deals with a future milestone (next_event_date >= today); ''false'' = everything else. Omit for both.'
        in: query
        name: upcoming
        required: false
        schema:
          type: string
      - description: 'YYYY-MM-DD: only deals whose next milestone (meeting, expected close or expected first trade) is on or before this date.'
        in: query
        name: next_event_lte
        required: false
        schema:
          type: string
      - description: Only rows updated at or after this timestamp (YYYY-MM-DD or YYYY-MM-DD HH:MM:SS); for incremental syncs.
        in: query
        name: updated_since
        required: false
        schema:
          type: string
      - description: '''latest'' (default): one row per deal with its current status. ''history'': the append-only status log, one row per transition (deal_id, status, date = filing date, created_at = when the pipeline first recorded it) for point-in-time replays.'
        in: query
        name: view
        required: false
        schema:
          enum:
          - latest
          - history
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
          description: Matching rows.
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/RateLimited'
      summary: 'De-SPAC lifecycle: one row per SPAC business combination tracked from the'
      tags:
      - De Spac Events
components:
  responses:
    Forbidden:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: 'PRO_SUBSCRIPTION_REQUIRED: the key''s plan does not include API access; every endpoint requires an active Pro subscription. DATE_RANGE_RESTRICTED: a legacy free-tier key asked for dates outside its window. In both cases the data is not missing.'
    Unauthorized:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Missing or unrecognized API key.
    BadRequest:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Invalid or conflicting query parameters.
    RateLimited:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Rate limit exceeded (600/min); the body carries retry_after_seconds.
  schemas:
    Envelope:
      properties:
        count:
          type: integer
        data:
          items:
            type: object
          type: array
      required:
      - count
      - data
      type: object
    Error:
      additionalProperties: true
      properties:
        error: {}
      type: object
  securitySchemes:
    ApiKeyHeader:
      in: header
      name: X-API-Key
      type: apiKey
    BearerKey:
      scheme: bearer
      type: http
externalDocs:
  description: MCP server exposing these datasets as tools (OAuth or X-API-Key).
  url: https://mcp.alphanume.com/mcp