Blockworks Acquisitions API

openapi: 3.2.0
info:
  description: The Blockworks Data API is a unified, read-only REST interface to Blockworks' warehouse-modeled crypto dataset, powered by Messari's research and data infrastructure.
  title: Blockworks Data Acquisitions API
  version: 0.1.0
servers:
- description: Blockworks API
  url: https://api.blockworks.com
security:
- apiKey: []
tags:
- description: 'Models documented under Acquisitions: Acquisition Deals (table).'
  name: Acquisitions
paths:
  /query/tabular/acquisition-deals:
    get:
      description: 'One row per merger or acquisition in the crypto industry, keyed by acquisitionDealID: announcement and funding dates, transaction amount when disclosed, status, and the acquiring and acquired entities with their sectors, logos and announcement URLs. Filter by date, amount, status or entity; sorted by announcement date.'
      operationId: getTabular_acquisition_deals
      parameters:
      - description: Acquisition Deal ID equals.
        in: query
        name: acquisitionDealIDEq
        schema:
          type: string
      - description: Acquisition Deal ID is one of (comma-separated).
        in: query
        name: acquisitionDealIDIsOneOf
        schema:
          items:
            type: string
          type: array
      - description: Acquisition Deal ID is not one of (comma-separated).
        in: query
        name: acquisitionDealIDIsNotOneOf
        schema:
          items:
            type: string
          type: array
      - description: Announcement Date is greater than.
        in: query
        name: announcementDateGt
        schema:
          format: date-time
          type: string
      - description: Announcement Date is greater than or equal to.
        in: query
        name: announcementDateGte
        schema:
          format: date-time
          type: string
      - description: Announcement Date is less than.
        in: query
        name: announcementDateLt
        schema:
          format: date-time
          type: string
      - description: Announcement Date is less than or equal to.
        in: query
        name: announcementDateLte
        schema:
          format: date-time
          type: string
      - description: Funding Date is greater than.
        in: query
        name: fundingDateGt
        schema:
          format: date-time
          type: string
      - description: Funding Date is greater than or equal to.
        in: query
        name: fundingDateGte
        schema:
          format: date-time
          type: string
      - description: Funding Date is less than.
        in: query
        name: fundingDateLt
        schema:
          format: date-time
          type: string
      - description: Funding Date is less than or equal to.
        in: query
        name: fundingDateLte
        schema:
          format: date-time
          type: string
      - description: Transaction Amount USD is greater than.
        in: query
        name: transactionAmountUSDGt
        schema:
          type: number
      - description: Transaction Amount USD is greater than or equal to.
        in: query
        name: transactionAmountUSDGte
        schema:
          type: number
      - description: Transaction Amount USD is less than.
        in: query
        name: transactionAmountUSDLt
        schema:
          type: number
      - description: Transaction Amount USD is less than or equal to.
        in: query
        name: transactionAmountUSDLte
        schema:
          type: number
      - description: Status equals.
        in: query
        name: statusEq
        schema:
          type: string
      - description: Status does not equal.
        in: query
        name: statusNotEq
        schema:
          type: string
      - description: Status is one of (comma-separated).
        in: query
        name: statusIsOneOf
        schema:
          items:
            type: string
          type: array
      - description: Status is not one of (comma-separated).
        in: query
        name: statusIsNotOneOf
        schema:
          items:
            type: string
          type: array
      - description: Acquiring Entity ID equals.
        in: query
        name: acquiringEntityIDEq
        schema:
          type: string
      - description: Acquiring Entity ID is one of (comma-separated).
        in: query
        name: acquiringEntityIDIsOneOf
        schema:
          items:
            type: string
          type: array
      - description: Acquiring Entity ID is not one of (comma-separated).
        in: query
        name: acquiringEntityIDIsNotOneOf
        schema:
          items:
            type: string
          type: array
      - description: Acquiring Entity Type equals.
        in: query
        name: acquiringEntityTypeEq
        schema:
          type: string
      - description: Acquiring Entity Type is one of (comma-separated).
        in: query
        name: acquiringEntityTypeIsOneOf
        schema:
          items:
            type: string
          type: array
      - description: Acquiring Entity Name equals.
        in: query
        name: acquiringEntityNameEq
        schema:
          type: string
      - description: Acquiring Entity Name is one of (comma-separated).
        in: query
        name: acquiringEntityNameIsOneOf
        schema:
          items:
            type: string
          type: array
      - description: Acquiring Entity Name contains (case-insensitive substring).
        in: query
        name: acquiringEntityNameContains
        schema:
          type: string
      - description: Acquiring Entity Slug equals.
        in: query
        name: acquiringEntitySlugEq
        schema:
          type: string
      - description: Acquiring Entity Slug is one of (comma-separated).
        in: query
        name: acquiringEntitySlugIsOneOf
        schema:
          items:
            type: string
          type: array
      - description: Acquiring Entity Is Active equals.
        in: query
        name: acquiringEntityIsActiveEq
        schema:
          type: boolean
      - description: Acquiring Entity Is Active does not equal.
        in: query
        name: acquiringEntityIsActiveNotEq
        schema:
          type: boolean
      - description: Acquired Entity ID equals.
        in: query
        name: acquiredEntityIDEq
        schema:
          type: string
      - description: Acquired Entity ID is one of (comma-separated).
        in: query
        name: acquiredEntityIDIsOneOf
        schema:
          items:
            type: string
          type: array
      - description: Acquired Entity ID is not one of (comma-separated).
        in: query
        name: acquiredEntityIDIsNotOneOf
        schema:
          items:
            type: string
          type: array
      - description: Acquired Entity Type equals.
        in: query
        name: acquiredEntityTypeEq
        schema:
          type: string
      - description: Acquired Entity Type is one of (comma-separated).
        in: query
        name: acquiredEntityTypeIsOneOf
        schema:
          items:
            type: string
          type: array
      - description: Acquired Entity Name equals.
        in: query
        name: acquiredEntityNameEq
        schema:
          type: string
      - description: Acquired Entity Name is one of (comma-separated).
        in: query
        name: acquiredEntityNameIsOneOf
        schema:
          items:
            type: string
          type: array
      - description: Acquired Entity Name contains (case-insensitive substring).
        in: query
        name: acquiredEntityNameContains
        schema:
          type: string
      - description: Acquired Entity Slug equals.
        in: query
        name: acquiredEntitySlugEq
        schema:
          type: string
      - description: Acquired Entity Slug is one of (comma-separated).
        in: query
        name: acquiredEntitySlugIsOneOf
        schema:
          items:
            type: string
          type: array
      - description: Acquired Entity Is Active equals.
        in: query
        name: acquiredEntityIsActiveEq
        schema:
          type: boolean
      - description: Acquired Entity Is Active does not equal.
        in: query
        name: acquiredEntityIsActiveNotEq
        schema:
          type: boolean
      - description: Acquired Entity Sector equals.
        in: query
        name: acquiredEntitySectorEq
        schema:
          type: string
      - description: Acquired Entity Sector is one of (comma-separated).
        in: query
        name: acquiredEntitySectorIsOneOf
        schema:
          items:
            type: string
          type: array
      - description: Acquired Entity Sector is not one of (comma-separated).
        in: query
        name: acquiredEntitySectorIsNotOneOf
        schema:
          items:
            type: string
          type: array
      - description: Acquired Entity Category equals.
        in: query
        name: acquiredEntityCategoryEq
        schema:
          type: string
      - description: Acquired Entity Category is one of (comma-separated).
        in: query
        name: acquiredEntityCategoryIsOneOf
        schema:
          items:
            type: string
          type: array
      - description: Acquired Entity Category is not one of (comma-separated).
        in: query
        name: acquiredEntityCategoryIsNotOneOf
        schema:
          items:
            type: string
          type: array
      - description: Field to sort by; defaults to the model's default sort column.
        in: query
        name: sortBy
        schema:
          default: announcementDate
          enum:
          - announcementDate
          - fundingDate
          - transactionAmountUSD
          - status
          - acquiringEntityName
          - acquiredEntityName
          type: string
      - description: Sort direction.
        in: query
        name: sortDirection
        schema:
          default: asc
          enum:
          - asc
          - desc
          type: string
      - description: 1-based page number.
        in: query
        name: page
        schema:
          type: integer
      - description: Rows per page (max 1000, default 100).
        in: query
        name: pageSize
        schema:
          type: integer
      - description: Comma-separated fields to return; defaults to all fields.
        in: query
        name: selections
        schema:
          items:
            enum:
            - acquisitionDealID
            - announcementDate
            - fundingDate
            - transactionAmountUSD
            - status
            - acquiringEntityID
            - acquiringEntityType
            - acquiringEntityName
            - acquiringEntitySlug
            - acquiringEntityLogoURL
            - acquiringEntityIsActive
            - acquiredEntityID
            - acquiredEntityType
            - acquiredEntityName
            - acquiredEntitySlug
            - acquiredEntityLogoURL
            - acquiredEntityIsActive
            - acquiredEntitySector
            - acquiredEntityCategory
            - announcementURLs
            type: string
          type: array
      - description: 'Response format, overriding the Accept header: json (default), csv, or jsonl (NDJSON). csv and jsonl return the rows as a downloadable file.'
        in: query
        name: acceptFormat
        schema:
          default: json
          enum:
          - json
          - csv
          - jsonl
          type: string
      responses:
        '200':
          content:
            application/json:
              example:
                data:
                - acquiredEntityCategory: <acquiredEntityCategory>
                  acquiredEntityID: <acquiredEntityID>
                  acquiredEntityIsActive: true
                  acquiredEntityLogoURL: <acquiredEntityLogoURL>
                  acquiredEntityName: <acquiredEntityName>
                  acquiredEntitySector: <acquiredEntitySector>
                  acquiredEntitySlug: <acquiredEntitySlug>
                  acquiredEntityType: <acquiredEntityType>
                  acquiringEntityID: <acquiringEntityID>
                  acquiringEntityIsActive: true
                  acquiringEntityLogoURL: <acquiringEntityLogoURL>
                  acquiringEntityName: <acquiringEntityName>
                  acquiringEntitySlug: <acquiringEntitySlug>
                  acquiringEntityType: <acquiringEntityType>
                  acquisitionDealID: <acquisitionDealID>
                  announcementDate: '2024-01-01T00:00:00Z'
                  announcementURLs:
                  - <announcementURLs>
                  fundingDate: '2024-01-01T00:00:00Z'
                  status: <status>
                  transactionAmountUSD: 123.45
                error: null
                metadata:
                  totalPages: 1
                  totalRows: 1
              schema:
                properties:
                  data:
                    items:
                      $ref: '#/components/schemas/AcquisitionDealsRow'
                    type: array
                  error:
                    type:
                    - string
                    - 'null'
                  metadata:
                    description: Pagination totals for the full filtered result set, independent of the current page.
                    properties:
                      totalPages:
                        format: int64
                        type: integer
                      totalRows:
                        format: int64
                        type: integer
                    required:
                    - totalRows
                    - totalPages
                    type: object
                required:
                - data
                - metadata
                type: object
            application/x-ndjson:
              schema:
                description: JSON Lines (NDJSON); one JSON object per line.
                type: string
            text/csv:
              schema:
                description: CSV with a header row; one row per record.
                type: string
          description: One page of matching rows, with the totals for the whole filtered set.
        '400':
          content:
            application/json:
              example:
                data: null
                error: unknown query parameter "acquisitionDealID"
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: 'The request is malformed: an unknown query parameter (a filter needs its operator suffix, such as acquisitionDealIDEq), a filter value of the wrong type, a sortBy field that is not sortable, an unknown selections field, or a pageSize above 1000.'
        '401':
          content:
            application/json:
              example:
                data: null
                error: this model requires authentication
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: No API key was sent and the model requires one.
        '403':
          content:
            application/json:
              example:
                data: null
                error: this model requires the "fundraising_unified" permission
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: The API key is not valid, or does not hold the "fundraising_unified" permission.
        '404':
          content:
            application/json:
              example:
                data: null
                error: tabular model "unknown-model" not found
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: 'The path names a model that does not exist: the slug is mistyped or the model was removed.'
      summary: List Acquisition Deals
      tags:
      - Acquisitions
      x-badges:
      - color: '#7c3aed'
        name: fundraising_unified
        position: after
      x-mint:
        metadata:
          sidebarTitle: List Acquisition Deals
          title: List Acquisition Deals
  /query/tabular/acquisition-deals/{acquisitionDealID}:
    get:
      description: 'One row per merger or acquisition in the crypto industry, keyed by acquisitionDealID: announcement and funding dates, transaction amount when disclosed, status, and the acquiring and acquired entities with their sectors, logos and announcement URLs. Filter by date, amount, status or entity; sorted by announcement date.'
      operationId: getTabularRow_acquisition_deals
      parameters:
      - description: The Acquisition Deal ID identifying the row.
        in: path
        name: acquisitionDealID
        required: true
        schema:
          type: string
      - description: Comma-separated fields to return; defaults to all fields.
        in: query
        name: selections
        schema:
          items:
            enum:
            - acquisitionDealID
            - announcementDate
            - fundingDate
            - transactionAmountUSD
            - status
            - acquiringEntityID
            - acquiringEntityType
            - acquiringEntityName
            - acquiringEntitySlug
            - acquiringEntityLogoURL
            - acquiringEntityIsActive
            - acquiredEntityID
            - acquiredEntityType
            - acquiredEntityName
            - acquiredEntitySlug
            - acquiredEntityLogoURL
            - acquiredEntityIsActive
            - acquiredEntitySector
            - acquiredEntityCategory
            - announcementURLs
            type: string
          type: array
      responses:
        '200':
          content:
            application/json:
              example:
                data:
                  acquiredEntityCategory: <acquiredEntityCategory>
                  acquiredEntityID: <acquiredEntityID>
                  acquiredEntityIsActive: true
                  acquiredEntityLogoURL: <acquiredEntityLogoURL>
                  acquiredEntityName: <acquiredEntityName>
                  acquiredEntitySector: <acquiredEntitySector>
                  acquiredEntitySlug: <acquiredEntitySlug>
                  acquiredEntityType: <acquiredEntityType>
                  acquiringEntityID: <acquiringEntityID>
                  acquiringEntityIsActive: true
                  acquiringEntityLogoURL: <acquiringEntityLogoURL>
                  acquiringEntityName: <acquiringEntityName>
                  acquiringEntitySlug: <acquiringEntitySlug>
                  acquiringEntityType: <acquiringEntityType>
                  acquisitionDealID: <acquisitionDealID>
                  announcementDate: '2024-01-01T00:00:00Z'
                  announcementURLs:
                  - <announcementURLs>
                  fundingDate: '2024-01-01T00:00:00Z'
                  status: <status>
                  transactionAmountUSD: 123.45
                error: null
                metadata:
                  matchedField: acquisitionDealID
              schema:
                properties:
                  data:
                    $ref: '#/components/schemas/AcquisitionDealsRow'
                  error:
                    type:
                    - string
                    - 'null'
                  metadata:
                    description: 'The public field the lookup value matched on: the primary key or an alternative identifier.'
                    properties:
                      matchedField:
                        type: string
                    required:
                    - matchedField
                    type: object
                required:
                - data
                - metadata
                type: object
          description: The matching row, and which field it matched on.
        '400':
          content:
            application/json:
              example:
                data: null
                error: unknown selection field "nope"
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: 'The request is malformed: an unknown query parameter, or a selections field the model does not have.'
        '401':
          content:
            application/json:
              example:
                data: null
                error: this model requires authentication
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: No API key was sent and the model requires one.
        '403':
          content:
            application/json:
              example:
                data: null
                error: this model requires the "fundraising_unified" permission
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: The API key is not valid, or does not hold the "fundraising_unified" permission.
        '404':
          content:
            application/json:
              example:
                data: null
                error: no row found matching "unknown"
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: No row's Acquisition Deal ID equals the path value, or the path names a model that does not exist.
      summary: Get Acquisition Deal
      tags:
      - Acquisitions
      x-badges:
      - color: '#7c3aed'
        name: fundraising_unified
        position: after
      x-mint:
        metadata:
          sidebarTitle: Get Acquisition Deal
          title: Get Acquisition Deal
components:
  schemas:
    ErrorResponse:
      properties:
        data:
          description: Always null on an error.
          type:
          - object
          - 'null'
        error:
          description: What went wrong, in one sentence.
          type: string
      required:
      - error
      - data
      type: object
    AcquisitionDealsRow:
      properties:
        acquiredEntityCategory:
          description: The legacy category classification of the acquired entity.
          type:
          - string
          - 'null'
        acquiredEntityID:
          description: The unique identifier of the project, organization, or product being acquired.
          type:
          - string
          - 'null'
        acquiredEntityIsActive:
          description: If true, the acquired entity is still an active entity.
          type:
          - boolean
          - 'null'
        acquiredEntityLogoURL:
          description: The URL of the acquired entity's logo.
          type:
          - string
          - 'null'
        acquiredEntityName:
          description: The name of the acquired entity.
          type:
          - string
          - 'null'
        acquiredEntitySector:
          description: The legacy sector classification of the acquired entity.
          type:
          - string
          - 'null'
        acquiredEntitySlug:
          description: The URL slug of the acquired entity.
          type:
          - string
          - 'null'
        acquiredEntityType:
          description: Whether the acquired entity is a project, an organization, or a product.
          type:
          - string
          - 'null'
        acquiringEntityID:
          description: The unique identifier of the project, organization, or governing body making the acquisition.
          type:
          - string
          - 'null'
        acquiringEntityIsActive:
          description: If true, the acquiring entity is still an active entity.
          type:
          - boolean
          - 'null'
        acquiringEntityLogoURL:
          description: The URL of the acquiring entity's logo.
          type:
          - string
          - 'null'
        acquiringEntityName:
          description: The name of the acquiring entity.
          type:
          - string
          - 'null'
        acquiringEntitySlug:
          description: The URL slug of the acquiring entity.
          type:
          - string
          - 'null'
        acquiringEntityType:
          description: Whether the acquiring entity is a project, an organization, or a governing body.
          type:
          - string
          - 'null'
        acquisitionDealID:
          description: The unique identifier of the acquisition deal.
          type:
          - string
          - 'null'
        announcementDate:
          description: The date the deal was announced.
          format: date-time
          type:
          - string
          - 'null'
        announcementURLs:
          description: The URLs of the announcements covering the deal, primary announcement first.
          items:
            type: string
          type:
          - array
          - 'null'
        fundingDate:
          description: The date the deal closed, when it differs from the announcement date.
          format: date-time
          type:
          - string
          - 'null'
        status:
          description: 'The status of the deal: announced, completed, or canceled. Values are lowercase.'
          type:
          - string
          - 'null'
        transactionAmountUSD:
          description: The value of the transaction, in US dollars. Null when the amount was not disclosed.
          type:
          - number
          - 'null'
      type: object
  securitySchemes:
    apiKey:
      description: API key sent in the `X-Blockworks-API-Key` header; `x-messari-api-key` is accepted for existing integrations. The catalog endpoints and models on the public access tier need no key.
      in: header
      name: X-Blockworks-API-Key
      type: apiKey
x-tagGroups:
- name: Meta
  tags:
  - Tabular
  - Timeseries
- name: Market Data
  tags:
  - Assets
  - Markets
  - Exchanges
  - Derivatives
  - Market Overview
- name: Blockchains
  tags:
  - Blockchains
- name: Projects & Protocols
  tags:
  - Projects & Entities
  - Protocol Revenue
  - Lending Protocols
  - Spot DEXes
  - Perp DEXes
  - Vaults
  - Launchpads
  - TCG Platforms
- name: Real World Assets
  tags:
  - Stablecoins
  - Tokenized Equities
  - Tokenized Commodities
- name: Institutional
  tags:
  - ETFs
  - Digital Asset Treasuries
- name: Fundraising
  tags:
  - Funding Rounds
  - Funds & Investors
  - Acquisitions
- name: Social & Mindshare
  tags:
  - Social & Mindshare
- name: News & Research
  tags:
  - News & Research
- name: Token Transparency Framework
  tags:
  - Token Transparency Framework