SPAC Research API Reference
Getting Started
SPAC Research's REST API uses standard HTTP codes, verbs, and authentication, and returns JSON-encoded responses.
All endpoints are hosted under the www.spacresearch.com
domain over HTTPS-only. All requests must
be authorized with the
HTTP Authorization
header.
Please read the API License Agreement before using the SPAC Research API.
May 17th, 2024 new
GET /api/v1/company
convertibleFinancing
preferredInvestment
Authentication
Send the HTTP Authorization
header in each request.
Substitute the text API_SECRET_TOKEN
in the example below with your API token, which can be found on
your
account page.
GET /api/v1/company HTTP/1.1
Host: www.spacresearch.com
Authorization: Bearer API_SECRET_TOKEN
The following Python script demonstrates Bearer token authentication, and requesting SPAC
data from the GET /api/v1/company
endpoint:
import requests
def get_active_companies():
end_point = "https://www.spacresearch.com/api/v1/company?status=active"
print("Connecting to: ", end_point)
token = "Bearer {}".format(YOUR_API_TOKEN)
return requests.get(end_point, headers={"Authorization": token})
Bulk SPAC Data
Request data for US-listed SPACs, by company status.
GET /api/v1/company
Example Requests
Get all active companies:
https://www.spacresearch.com/api/v1/company
Get all pre-IPO companies:
https://www.spacresearch.com/api/v1/company?status=pre-ipo
Get the name and IPO date of each company with a closed deal:
https://www.spacresearch.com/api/v1/company?status=deal-closed&select=name,ipoDate
Query Parameters
Name | Value |
---|---|
status |
(Optional) Filter companies in response by status.
Other
|
select |
(Optional) Comma-separated list of field names to include in the response. Example: |
Response Schema
Name | Description | Type | Status |
---|---|---|---|
id |
Unique identifier for each SPAC | String (UUID) | Default |
name |
Corporate name of entity | String | Default |
abbreviatedName |
An abbreviated version of the corporate entity's name |
String | Default |
status |
One of pre-ipo , pre-deal , live-deal , deal-closed ,
stalled , or liquidated
|
String | Default |
symbols |
Array of symbol metadata; see Symbol metadata section | Array | Default |
secFilingLink |
Link to the SPAC's SEC filing index | String | Default |
initialS1Date |
Date of initial S-1 filing | String (ISO-8601) | Default |
tenor |
Life of SPAC in months, including sponsor-optional extensions | String | Default |
unitSpecs |
Composition of units. Example: U=S+W/2 . Meaning: Units consist of one common share and ½ warrant
|
String | Default |
warrantSpecs |
Composition of warrants. Example: W=S@11.5 . Meaning: Warrants can purchase one share of common
stock at a price of $11.50 per share.Note: this field may occasionally contain asterisks that will require manual attention to parse. |
String | Default |
rightSpecs |
Composition of rights. Note: this field may occasionally contain asterisks that will require manual attention to parse. |
String | Default |
warrantRedemptionPrice |
Price above which warrants may be called for redemption | Numeric | Default |
warrantCrescentTerm |
Warrant exercise adjustment threshold price for equity issuance at business combination closing | Numeric | Default |
underwriters |
Array of underwriter objects; see Underwriters section | Array | Default |
sponsorFamilies |
Array of sponsor objects; see Sponsors section | Array | Default |
sponsorType |
Type of entity sponsoring the SPAC: IB, HF, PE, VC, FO, Independent (former public company CEO), Independent (other) | String | Default |
anchorInvestors |
Array of anchor investor objects; see Anchor Investors section | String | Default |
personnel |
Array of personnel metadata; see Directors & Officers section | Array | Default |
issuerCounsel |
Issuer Legal Counsel | String | Default |
auditor |
Auditor | String | Default |
underwriterCounsel |
Underwriter Legal Counsel | String | Default |
incorporation |
Corporate domicile | String | Default |
address |
Corporate address | String | Default |
publicUnits |
Number of public units sold at IPO, including over-allotment | Numeric | Default |
unitIpoPrice |
Price per unit of SPAC IPO | Numeric | Default |
ipoCashInTrust |
Percentage representing the amount of capital raised at IPO that was deposited in the SPAC's trust account (per share) | String | Default |
trustAtIpo |
Aggregate value of cash deposited into the SPAC's trust account at IPO (including over-allotment, if finalized) | Numeric | Default |
notableAffiliates |
Notable entities affiliated with the SPAC or its sponsor | String | Default |
intendedSector |
Long-form description of SPAC focus area from S-1 | String | Default |
ipoSectorTag |
SPAC Sector Focus at IPO | String | Default |
ipoGeographyTag |
SPAC Geographic Focus at IPO | String | Default |
mergerSectorTag |
Sector of SPAC Acquisition Target | String | Default |
mergerGeographyTag |
Geography of SPAC Acquisition Target | String | Default |
fpaAmount |
Dollar amount of forward purchase commitment | Numeric | Default |
forwardPurchaser |
Name(s) of forward purchase investors | String | Default |
fpaContent |
Details of forward purchase commitment | String | Default |
bcma |
Business combination marketing agreement as a percentage of IPO proceeds | String | Default |
uwDeferred |
Deferred underwriting commissions payable to underwriters upon closing of initial business combination | String | Default |
uwUpfront |
Upfront underwriting commissions earned by underwriters | String | Default |
timeWindowTooltip |
Detailed description of SPAC's tenor/lifespan | String | Default | trustAcctValue |
Value of trust account | Numeric | Pre-IPO Active |
trustSharePrice |
Last reported trust value | Numeric | Pre-IPO Active |
trustAcctDate |
Date of SPAC's most recent definitive trust account update | String (ISO-8601) | Active |
trustHeldInCash |
Binary flag representing whether or not the SPAC has given guidance indicating a reasonable likelihood of having moved its trust account to cash Type: Boolean | Boolean | Active |
estimatedCashInTrustPerShare |
Estimated current cash in trust per share, per SPAC Research estimated trust model. Uses most recent reported trust value from company filings and applies lookback on 1- and 6-month Treasury rates. Accounts for income & franchise taxes, sponsor contributions to trust, and working capital withdrawals (if any). THIS FIELD IS ONLY AN ESTIMATE. |
Numeric | Active |
estimatedCashAtLiquidation |
Estimated cash in trust per share at End Date. Assumes no optional extensions. | Numeric | Active |
trustEstimateUpdated |
Date and time of last update to estimated trust value. | String (ISO-8601) | Active |
target |
True if the SPAC has an active definitive business combination agreement, otherwise false | Boolean | Active |
targetName |
Name of acquisition target/newco | String | Active Archive |
publicSharesOutstanding |
Number of outstanding public shares after any effected extension/closing redemptions | Numeric | Active |
enterpriseValue |
Pro forma enterprise value of newco | Numeric | Active Archive |
publicWarrantsOutstanding |
Number of outstanding warrants | Numeric | Active Archive |
ipoDate |
First date of live trading of units | String (ISO-8601) | Active Archive |
dealAnnouncementDate |
Date of business combination announcement | String (ISO-8601) | Active Archive |
atRiskCapital |
Dollar amount of risk capital securities purchased by sponsor | Numeric | Active Archive |
atRiskUnitsPurchased |
Number of private placement units purchased by sponsor as part of risk capital purchase (if any) | Numeric | Active Archive |
atRiskCommonPurchased |
Number of private placement common shares purchased by sponsor as part of risk capital purchase (if any) | Numeric | Active Archive |
atRiskWarrantsPurchased |
Number of private placement warrants purchased by sponsor as part of risk capital purchase (if any) | Numeric | Active Archive |
atRiskRightsPurchased |
Number of private placement right purchased by sponsor as part of risk capital purchase (if any) | Numeric | Active Archive |
atRiskSponsorPromoteShares |
Original number of promote shares owned by the SPAC's sponsor | Numeric | Active Archive |
pipeInvestment |
Dollar value of PIPE commitments subscribed for in connection with initial business combination | Numeric | Active Archive |
pipePrice |
Price per share at which PIPE commitments were/are to be funded | Numeric | Active Archive |
pipeWarrantConsideration |
Total warrants (if any) granted to PIPE purchasers in connection with initial business combination | Numeric | Active Archive |
minCashCondition |
Minimum cash requirement for seller to be required to consummate business combination | Numeric | Active Archive |
endDate |
Date by which SPAC must consummate a business combination or commence liquidating its trust account | String (ISO-8601) | Active |
mergerOutsideDate |
If present, date after which a SPAC’s definitive business combination agreement may be terminated. Merger Outside Date may be conditional and should be carefully reviewed. |
String (ISO-8601) | Active |
outsideLiquidationDate |
If present, date to which SPAC's liquidation deadline may be extended without submission for shareholder vote. | String (ISO-8601) | Active |
closingOrLiquidationDate |
Date on which this SPAC moved from "active" to "archive" status due to either closing of initial business combination or liquidation | String (ISO-8601) | Active Archive |
proxyFilingDate |
Date on which the first preliminary proxy related to the SPAC’s business combination was filed | String (ISO-8601) | Active Archive |
newTickerSymbol |
New ticker symbol for post-merger common stock (if present) | String | Active Archive |
archiveSymbols |
Array of post-merger symbol metadata; see Archive Symbol metadata section | Array | Active Archive |
redemptionRatio |
Percentage of original SPAC public shares that were redeemed over the course of that SPAC's life. | String | Archive |
convertiblePreferredInvestment |
Amount of investment in convertible or preferred equity made at deal closing. | Numeric | Active Archive |
conversionStrikePrice |
Price at which convertible/preferred investment may be converted into common equity. | Numeric | Active Archive |
closingFpaInvestment |
Amount of FPA that was actually effected at closing, in dollars. | Numeric | Active Archive |
closingFpaShares |
Number of shares of common stock received by investors in connection with Closing FPA Investment. | Numeric | Active Archive |
closingFpaWarrantConsideration |
Number of warrants (if any) received by investors in connection with Closing FPA Investment. | Numeric | Active Archive |
closingFpaImpliedPrice |
Implied price per share of common equity purchased in closing FPA Investment (including all shares received by purchasers but ignoring the value of any warrant consideration). | Numeric | Active Archive |
backstopInvestment |
Amount of any backstop investment actually effected at closing. | Numeric | Active Archive |
backstopImpliedPricePerShare |
Implied price per share of common equity purchased in backstop investment at closing (including all shares received by purchasers but ignoring the value of any warrant consideration). | Numeric | Active Archive |
backstopShares |
Number of shares of common stock received by investors in connection with Backstop Investment. | Numeric | Active Archive |
backstopWarrantConsideration |
Number of warrants (if any) received by backstop investors in connection with backstop investment. | Numeric | Active Archive |
sponsorShareForfeiture |
Number of shares conditionally or unconditionally forfeited by sponsor in connection with deal closing. | Numeric | Archive |
sponsorWarrantForfeiture |
Number of warrants conditionally or unconditionally forfeited by sponsor in connection with deal closing. | Numeric | Archive |
sellerEarnout |
Array of seller Earnout objects; see Seller Earnout Metadata section | Array | Archive |
sponsorEarnout |
Array of sponsor Earnout objects; see Sponsor Earnout Metadata section | Array | Archive |
sellerLockup |
Array of seller Lockup objects; see Seller Lockup Metadata section | Array | Archive |
sponsorLockup |
Array of sponsor Lockup objects; see Sponsor Lockup Metadata section | Array | Archive |
convertibleFinancing |
Array of convertible finance Lockup objects; see Convertible Financing Metadata section | Array | Active Archive |
preferredInvestment |
Amount of investment in preferred equity made in connection with deal closing | Numeric | Active Archive |
/company?status=
values in the table above.
Default fields are returned for all statuses.
"abbreviatedName": "XYZ Strategic Growth",
"address": "123 West 57th Street, 49th Floor New York, NY 10019",
"atRiskCapital": 18336201,
"atRiskCommonPurchased": 1100000,
"atRiskSponsorPromoteShares": 20420250,
"atRiskUnitsPurchased": 500000,
"atRiskWarrantsPurchased": 12224134,
"bcma": "3.50%",
"auditor": "WithumSmith+Brown",
"backstopImpliedPricePerShare": 10.20,
"backstopInvestment": 4151400,
"backstopShares": 407000,
"backstopWarrantConsideration": 3250000,
"closingFpaImpliedPrice": 10.00,
"closingFpaInvestment": 300000000,
"closingFpaShares": 30000000,
"closingOrLiquidationDate": "2018-02-06",
"composition": {
"unit": {
"share": 1,
"warrant": 0.3333333333333333
},
"warrant": {
"share": 1,
"strike": 11.5
}
},
"conversionStrikePrice": 5.00,
"convertiblePreferredInvestment": 4000000,
"dealAnnouncementDate": "2021-02-17",
"endDate": "2022-10-06",
"enterpriseValue": 1638000000,
"estimatedCashAtLiquidation": 10.028,
"estimatedCashInTrustPerShare": 10.01,
"forwardPurchaser": "X Holdings and Y LLC",
"fpaAmount": 300000000,
"fpaContent": "* Each of X and Y have entered in FPAs to purchase $150mm (or a total of $300mm) of securities at business combination",
"id": "b2c10a29-0c18-442a-9be4-5e9604700044",
"incorporation": "Cayman Islands",
"initialS1Date": "2020-09-16",
"intendedSector": "Not specified",
"ipoCashInTrust": "100.0%",
"ipoDate": "2020-10-02",
"ipoGeographyTag": "Global",
"ipoSectorTag": "General",
"issuerCounsel": "Paul, Weiss, Rifkind, Wharton & Garrison",
"mergerGeographyTag": "US\/Canada",
"mergerOutsideDate": "2021-12-31",
"mergerSectorTag": "Automotive",
"minCashCondition": 225000000,
"name": "XYZ Strategic Growth Capital",
"newTickerSymbol": "XYZZ",
"notableAffiliates": "Apollo Global Management, Inc.",
"outsideLiquidationDate": "2023-01-06",
"pipeInvestment": 225000000,
"pipePrice": 10.00,
"pipeWarrantConsideration": 4100000,
"proxyFilingDate": "2021-05-13",
"publicSharesOutstanding": 81681000,
"publicUnits": 81681000,
"publicWarrantsOutstanding": 27227000,
"redemptionRatio": "84.2%",
"rightSpecs": "R=S\/20",
"rootSymbol": "APSG.U",
"secFilingLink": "https:\/\/www.sec.gov\/edgar\/browse\/?CIK=0001820872",
"sponsorType": "PE (Private Equity)",
"status": "pre-ipo",
"target": false,
"targetName": "AEye",
"tenor": "24+(3)",
"timeWindowTooltip": "12 months, plus 2 optional 3 month extensions, each of which require a $0.10 per public share deposit from sponsor to the trust account"
"trustAcctDate": "2021-03-31",
"trustAcctValue": 817161720,
"trustAtIpo": 816810000,
"trustEstimateUpdated": "2022-03-09T07:56:52.000-06:00",
"trustHeldInCash": true,
"trustSharePrice": 10.00,
"underwriterCounsel": "White & Case",
"unitIpoPrice": 10.0,
"unitSpecs": "U=S+W\/3",
"uwDeferred": "3.50%",
"uwUpfront": "2.00%",
"warrantCrescentTerm": 9.20,
"warrantRedemptionPrice": 18.00,
"warrantSpecs": "W=S@11.5",
"sponsorShareForfeiture": 2565885,
"sponsorWarrantForfeiture": 2565885
Symbol Metadata
Name | Description | Type |
---|---|---|
symbol |
Ticker symbol | String |
type |
Stock type e.g. common, units, warrants, rights | String |
isin |
International Securities Identification Number
Copyright © 2024, American Bankers Association CUSIP Database provided by S&P Global Market Intelligence LLC. All rights reserved. |
String |
cusip |
Committee on Uniform Securities Identification Procedures
Copyright © 2024, American Bankers Association CUSIP Database provided by S&P Global Market Intelligence LLC. All rights reserved. |
String |
"symbols": [
{
"symbol": "MNCLU",
"type": "units",
"cusip": "609754205",
"isin": "US6097542053"
},
{
"symbol": "MNCLW",
"type": "warrants",
"cusip": "609754114",
"isin": "US6097541147"
},
{
"symbol": "MNCL",
"type": "common",
"cusip": "609754106",
"isin": "US6097541063"
}
],
Archive Symbol Metadata
Name | Description | Type |
---|---|---|
symbol |
Ticker symbol | String |
type |
Stock type e.g. common, warrants | String |
isin |
International Securities Identification Number
Copyright © 2024, American Bankers Association CUSIP Database provided by S&P Global Market Intelligence LLC. All rights reserved. |
String |
cusip |
Committee on Uniform Securities Identification Procedures
Copyright © 2024, American Bankers Association CUSIP Database provided by S&P Global Market Intelligence LLC. All rights reserved. |
String |
"archiveSymbols": [
{
"symbol": "CCNC",
"type": "common",
"cusip": "19200A105",
"isin": "US19200A1051"
},
{
"symbol": "CCNCW",
"type": "warrants",
"cusip": "19200A113",
"isin": "US19200A1135"
}
],
Underwriters
Name | Description | Type |
---|---|---|
name |
Underwriter name | String |
units |
Number of units sold by underwriter | Numeric |
bookRunningManager |
True if the underwriter is the designated book-running manager | Boolean |
"underwriters": [
{
"name": "Cowen and Company, LLC",
"units": 12000000,
"bookRunningManager": true
},
{
"name": "Chardan Capital Markets, LLC",
"units": 3000000,
"bookRunningManager": true
}
],
Sponsor Families
Name | Description | Type |
---|---|---|
Name | Sponsor name | String |
"sponsorFamilies": [
{
"name": "Apollo Global Management"
},
{
"name": "Cohen and Company"
}
],
Directors & Officers
Name | Description | Type |
---|---|---|
name |
Director or officer name | String |
position |
Director or officer position | String |
"personnel": [
{
"name": "Linda Sample",
"position": "Chief Executive Officer and Director"
},
{
"name": "Fred Sample",
"position": "Director"
}
],
Anchor Investors
Name | Description | Type |
---|---|---|
name |
Name of anchor investor | String |
size |
Size of anchor investment, measured as a proportion of original IPO size without over-allotment | Numeric |
"anchorInvestors": [
{
"name": "D. E. SHAW & CO., INC.",
"size": 9.9
},
{
"name": "RADCLIFFE CAPITAL MANAGEMENT, L.P.",
"size": 9.9
}
],
Seller Earnout Metadata
Name | Description | Type |
---|---|---|
amount |
Number of shares sellers can earn upon achievement of the relevant milestone and within the specified timeframe | Numeric |
period |
Time period over which earnout shares may be earned | String |
trigger |
Milestone to be achieved for earnout shares to be released | String |
"sellerEarnout": [
{
"amount": 2570000,
"period": "10 years",
"trigger": "$12.50"
},
{
"amount": 2570000,
"period": "10 years",
"trigger": "$15.50"
}
],
Sponsor Earnout Metadata
Name | Description | Type |
---|---|---|
amount |
Number of shares sponsor can earn upon achievement of the relevant milestone and within the specified timeframe | Numeric |
period |
Time period over which earnout shares may be earned | String |
trigger |
Milestone to be achieved for earnout shares to be released | String |
"sponsorEarnout": [
{
"amount": 2570000,
"period": "10 years",
"trigger": "$12.50"
},
{
"amount": 2570000,
"period": "10 years",
"trigger": "$15.50"
}
],
Seller Lockup Metadata
Name | Description | Type |
---|---|---|
amount |
Number of shares that will be released to sellers upon expiration of the relevant lockup period | Numeric |
period |
Length of period upon which lockup shares will be unconditionally released to sellers | String |
trigger |
Milestone which will end lockup period early | String |
"sellerLockup": [
{
"amount": 2570000,
"period": "10 years",
"trigger": "$12.50"
},
{
"amount": 2570000,
"period": "10 years",
"trigger": "$15.50"
}
],
Sponsor Lockup Metadata
Name | Description | Type |
---|---|---|
amount |
Number of shares that will be released to sponsor upon expiration of the relevant lockup period | Numeric |
period |
Length of period upon which lockup shares will be unconditionally released to sponsor | String |
trigger |
Milestone which will end lockup period early | String |
"sponsorLockup": [
{
"amount": 2570000,
"period": "10 years",
"trigger": "$12.50"
},
{
"amount": 2570000,
"period": "10 years",
"trigger": "$15.50"
}
],
Convertible Financing Metadata
Name | Description | Type |
---|---|---|
amount |
Dollar amount of convertible financing | Numeric |
investor |
Investor(s) responsible for purchase of convertible securities | Array |
conversionPrice |
Price at which securities will be convertible into common equity | Numeric |
variableConversionPrice? |
Boolean flag representing whether the convertible securities have a variable conversion price. See notes for more details | Boolean |
interestRate |
Rate at which securities will accrue interest payable | Numeric |
notes |
Additional details | String |
warrantExercise |
Price at which warrants attached to convertible securities are exercisable | Numeric |
maturity |
Duration of convertible investment | String |
warrants |
Number of warrants issued to convertible investors in connection with investment | Numeric |
warrantExpiration |
Date after which warrants may no longer be exercised | String |
"convertibleFinancing": [
{
"amount": "10000000",
"investor": [
"Hunch Ventures",
"40 North"
],
"conversionPrice": "$12.50",
"variableConversionPrice?": False,
"interestRate": "8.00%",
"notes": "",
"warrantExercise": "$24.00",
"maturity": "3 yrs 9 mos",
"warrants": 1000000,
"warrantExpiration": "2 weeks"
},
{
"amount": "13000000",
"investor": [
"FutureTech Capital LLC"
],
"conversionPrice": "",
"variableConversionPrice?": True,
"interestRate": "",
"notes": "Conversion price is the lower of $8.00 and the product
of the daily VWAP of the common stock over a
consecutive 20 trading days ending on and including
the date of the conversion, multiplied by 80%
and shall not be less than $5.00",
"warrantExercise": "$8.00",
"maturity": "",
"warrants": 2600000,
"warrantExpiration": "5 years, commencing 6 months from closing"
}
],
SPAC Lookup
Request data on a specific SPAC.
GET /api/v1/company/:id
Path Parameters
Name | Value |
---|---|
:id |
The following identifiers are accepted:
|
Request Examples
-
Get a company by ID:
GET /api/v1/company/99a035ce-e3df-42ef-b545-743ff3d982a6
-
Get a company by root symbol:
GET /api/v1/company/MNCLU
Response Schema
Returns a single company object, using the response schema of the GET
/api/v1/company
endpoint above.
Event Feed
Get a feed of SPAC events.GET /calendar.json
Query Parameters
Name | Value |
---|---|
since |
(Optional) Earliest event date, e.g. 2021-03-23 |
Request Examples
-
Get events dating back to the beginning of the current month:
GET /calendar.json
-
Get events dating back to January 15, 2021:
GET /calendar.json?since=2021-01-15
Response Schema
Name | Description | Type |
---|---|---|
id |
Unique identifier for each calendar event | String |
root-symbol |
Company identifier | String |
company-name |
Name of SPAC | String |
date |
Event date | String (ISO-8601) |
title |
Event title | String |
record-date |
Record date of meeting (if any) | String (ISO-8601) |
[
{
"root-symbol": "BLNGU",
"company-name": "Belong Acquisition Corp.",
"date": "2021-07-23",
"title": "IPO",
"id": "b184ccfb-9ab6-3a6a-ae59-e59676d796d5",
},
{
"root-symbol": "CCIV.U",
"company-name": "Churchill Capital Corp IV",
"date": "2021-07-23",
"title": "Lucid Motors Vote",
"id": "3c929dc8-a2ed-32b6-b4e9-76717eb82430",
"record-date" : "2021-08-23"
},
{
"root-symbol": "AAOIU",
"company-name": "American Acquisition Opportunity Inc.",
"date": "2022-03-22",
"title": "Liq. date",
"id": "8ea2ebf7-da07-38b9-894c-4aa52e5b9e5b"
}
]