Enterprise X
EnterpriseX is a server to server distribution medium for QuoteMedia's financial data via Request API. The system is designed to provide intraday snap information and end of day bulk information to authorized users (IP, Token, User Session). EnterpriseX operates as a polled data source using http for the transport and XML or JSON for the encoding.
Access Control
Request Structure:
The requests are simple http get requests on port 80 to app.quotemedia.com (West Coast) or quotes.quotemedia.com (East coast) which you pass a set of parameters to configure the response you want to receive. Request API Data Center Failover Protocols.
The request uses the Restful BEST Practices, for more details click here
Response Structure:
The response to the request is an XML or JSON document containing the data.
FPOsByCountry
The FPOsByCountry API provides the ability to search for all companies that have had an FPO within a specified time frame. FPOs for US and Canada are supported with historical data starting from January 2021.
Please note that API requests for an entire country tend to return file sizes too large to be processed by internet browsers.
Output Variables
| Fields | Data Type | Description |
|---|---|---|
| pageNumber | Integer | Page number |
| totalPages | Integer | Total number of pages |
| nextPage | String | URL of next page |
| copyright | String | QuoteMedia copyright |
| country | String | Country for requested data. |
| offerings | Section header | |
| offertype | String | The type of public listing occurring. output = IPO, SPAC [Special Purpose Acquisition Company], DL [Direct Listing]. |
| offerStatus | String | The status of the offer from the issuer. output = Open/ Closed |
| listingStatus | String | Listing Status. output = Listed/ listing pending |
| use of proceeds | String | Description of what the capital funding will be used for. |
| offeringAnnouncementDate | Date (YYYY-MM-DD) | The date the offer was announced. |
| shareIssueDate | Date (YYYY-MM-DD) | Date when share issued |
| strategicSharesOffered | Date (YYYY-MM-DD) | Strategic shares offered |
| underwritingDiscount | Float | Discount given to the underwriters, amount per unit. |
| proceedsAfterExpenses | Float | Part of price which remains after expenses |
| shareholderSharesOffered | Integer | Number of shares which shareholder released |
| lockupPeriod | Integer | Period of time for which shares cannot be sold by company insiders after Public Listing. |
| lockupExpirationDate | Date (YYYY-MM-DD) | End date of lockup period. |
| quietPeriodExpirationDate | Date (YYYY-MM-DD) | Quiet period expiration date |
| numberOfSharesIssued | Integer | Total number of shares issued |
| strategicSaleOfferThatWereIssued | Integer | Strategic shares issued |
| greenshoeOptionExerciseDate | Date (YYYY-MM-DD) | Greenshoe Option Exercise Date |
| totalOfferingExpense | Float | Total offering expense |
| numberOfGreenshoeShares | Integer | Number of Greenshoe Shares underwriter could subscribe to |
| dateOfFiling | Date (YYYY-MM-DD) | Date on which first filing related to offering submitted to SEC, SEDAR, FCA by company. |
| expectedOfferingStartDate | Date (YYYY-MM-DD) | Anticipated/forecasted date for IPO offering start date |
| offerAmountMin | Integer | Minimum forecasted total value of the securities being issued in the event |
| offerAmountMax | Integer | Maximum forecasted total value of the securities being issued in the event |
| sharesOverAllotted | Integer | Number of shares allotted above original offerings. AKA Greenshoe shares. |
| registrationFee | Float | Fees need to pay registration |
| typeOfEquityInstrument | String | Type of instrument being issued. Output can be custom, but typically includes: Class A/B Common Shares Warrants Options Subscription Receipts Debt Securities Units American Depositary Shares (ADS) Preferred Shares |
| warrantsIssued | Float | Warrants issued |
| legalFeesExpense | Float | Legal Fees Expenses |
| securityParvalue | Float | Nominal or par value of the security issued |
| expriceOfWarrants | Float | Exercise Price of Warrants |
| expectedDateOfListing | Date (YYYY-MM-DD) | Anticipated or Forecasted Date of Listing/First Day of Trading, based on latest SEC Filings. |
| symbol | String | Symbol |
| companyName | String | company |
| exchange | String | Listing Exchange of company/symbol |
| currency | String | The currency of the security (which can differ from the country) |
| offerPrice | Float | Final price at which the issuer offers their securities to the investors participating in the IPO. AKA issue price, IPO price. |
| priceRangeMax | Float | Highest offer price forecast pre-IPO |
| priceRangeMin | Float | Lowest offer price forecast pre-IPO |
| maxSharesOffered | Integer | Maximum shares offered during IPO |
| minSharesOffered | Integer | Minimum shares offered during IPO |
| dateOfListing | Date (YYYY-MM-DD) | Date the securities begin trading on exchange. First Trading Date. |
| offerAmount | Float | The total value of the securities being issued in the event. Calculated as offer price x shares |
| status | String | Status of the event overall C= Cancelled F= Filing U=Upcoming A= Announced L= Postponed W= Withdrawn T=Trading R= Rumour P= Pending N= New H= History |
| leadUnderwriter | String | Lead IPO underwriter |
| underwriter | String | IPO underwriter |
| underwriterCounsel | String | Underwriter Counsel |
| companyCounsel | String | Law firm company name |
| transferAgent | string | Transfer Agent name |
Input Variables
Fields | Required | Default | Range of Values | Description |
|---|---|---|---|---|
| investment_trusts | No | false | True or False | If set to true only Investment Trust FPOs will be displayed in the output. |
country | Yes (either country or symbol is required) | US | Type: Text Country Codes: | Country for requested data. Cannot be used with the symbol input parameter. |
current | No | current date | date(YYYY-MM-DD) | Enter in the date for requested data or with no input the most recent symbol change will display. |
start | No | none | date(YYYY-MM-DD) | Allows for the specification of a start date. Accepted format is YYYY-MM-DD historical data starting from December 2020. |
end | No | none | date(YYYY-MM-DD) | Allows for the specification of an end date. Accepted format is YYYY-MM-DD. Must be used in conjunction with the start input parameter. |
page | No | 1 | Unlimited | Page number of query results |
results_per_page | No | none | Unlimited | Number of records to show per page |
exclude | No | S | any output data point | Allows for the exclusion of specific data points (Up to a maximum of 5). Ex. When exclude=open is used, all open values will be hidden in the output. |
webmaster_id | Yes | none | Numeric value | QuoteMedia attaches a unique id to your company that allows us to entitle you to specific data and products |
content_type | No | json | Type: Text - json or xml | Format of output |
| unscheduled | No | false | true/false | Allows for the inclusion of upcoming ipo records that do not yet have a dateOfListing provided |
| include_nulls | No | none | true/false | When set to true, null value fields will be included in the output. |
| fields | No | none | String | The fields input parameter allows to define which fields you want to include in the output and which ones you don't. If the field isn't nested, it can be included directly. If it is nested then it will need to use syntax such as - object1[fieldX,fieldY] If excluding specific fields, start the request with a '!'. If excluding a nested field then use syntax such as - !object1[fieldX,fieldY] For a more detailed explanation please see this article here |
Sample Request - FPOsByCountry
This API brings back FPOsByCountry Data for the United States in JSON
Browser Request - https://app.quotemedia.com/v2/events/fpos?webmaster_id=XXXXXX&start=2021-01-01&end=2021-06-01&country=US
User-based Session Request - https://app.quotemedia.com/v2/events/fpos?webmaster_id=XXXXXX&start=2021-01-01&end=2021-06-01&country=US&sid=[extracted_sid]
This API brings back FPOsByCountry Data for the United States in XML
Browser Request - https://app.quotemedia.com/v2/events/fpos?webmaster_id=XXXXXX&start=2021-01-01&end=2021-06-01&country=US&content_type=xml
Sample Result - FPOsByCountry - JSON
Results based on
https://app.quotemedia.com/v2/events/fpos?webmaster_id=XXXXXX&start=2021-01-01&end=2021-06-01&country=US
*Results limited to show just the first few
{"results": {"pageNumber": 4,"totalPages": 21,"nextPage": "https://app.quotemedia.com/v2/events/fpos?webmaster_id=91924&start=2021-01-01&end=2021-06-01&country=US&results_per_page=10&page=5","prevPage": "https://app.quotemedia.com/v2/events/fpos?webmaster_id=91924&start=2021-01-01&end=2021-06-01&country=US&results_per_page=10&page=3","copyright": "Copyright (c) 2022 QuoteMedia, Inc.","country": "US","offerings": [{"offerType": "FPO","listingStatus": "Listed","useOfProceeds": "All proceeds from the sale of shares of common stock under this prospectus will be for the account of the selling stockholders","dateOfFiling": "2021-08-05","offerAmountMin": 250000000,"registrationFee": 27275,"symbol": {"symbol": "SPNE","companyName": "SeaSpine Holdings Corp","exchange": "NSD","currency": "USD"},"dateOfListing": "2021-04-19","status": "F","lawFirm": "DLA Piper LLP","transferAgent": "American Stock Transfer & Trust Company LLC","openingPrice": 19},{"offerType": "FPO","listingStatus": "Listed","useOfProceeds": "We intend to use the net proceeds from this offering, together with our existing cash and cash equivalents, as follows:1.the advancement of SYNB1934 into the Phase 2 SynPheny study;2.preparations for a Phase 3 clinical trial in PKU with SYNB1618 or SYNB1934; and 3.general corporate purposes.","offeringAnnouncementDate": "2021-04-16","underwritingDiscount": 0.18,"proceedsAfterExpenses": 2.82,"lockupPeriod": 180,"lockupExpirationDate": "2022-03-22","quietPeriodExpirationDate": "2021-11-02","dateOfFiling": "2021-07-23","offerAmountMin": 45000000,"registrationFee": 27275,"typeOfEquityInstrument": "Common Shares","securityParvalue": 0.001,"symbol": {"symbol": "SYBX","companyName": "Synlogic Inc","exchange": "NSD","currency": "USD"},"offerPrice": 3,"priceRangeMax": 3,"priceRangeMin": 3,"sharesOffered": 15000000,"dateOfListing": "2021-04-19","offerAmount": 45000000,"status": "T","underwriter": "SVB Leerink LLC,Jefferies LLC","lawFirm": "Mintz, Levin, Cohn, Ferris, Glovsky and Popeo, PC","transferAgent": "American Stock Transfer & Trust Company LLC","openingPrice": 50.75},{"offerType": "FPO","offerStatus": "Closed","listingStatus": "Listed","lockupPeriod": 180,"lockupExpirationDate": "2021-10-13","quietPeriodExpirationDate": "2021-05-26","totalOfferingExpense": 555398,"offerAmountMin": 50000000,"symbol": {"symbol": "JOB","companyName": "GEE Group Inc","exchange": "NYE","currency": "USD"},"offerPrice": 0.6,"priceRangeMax": 0.6,"priceRangeMin": 0.6,"sharesOffered": 83333333,"dateOfListing": "2021-04-16","offerAmount": 49999999.8,"status": "T","openingPrice": 5.37318},{"offerType": "FPO","offerStatus": "Closed","listingStatus": "Listed","lockupPeriod": 180,"lockupExpirationDate": "2021-10-12","quietPeriodExpirationDate": "2021-05-25","offerAmountMin": 13050000,"symbol": {"symbol": "PHX","companyName": "PHX MINERALS INC","exchange": "NYE","currency": "USD"},"offerPrice": 2.61,"priceRangeMax": 2.61,"priceRangeMin": 2.61,"sharesOffered": 5000000,"dateOfListing": "2021-04-15","offerAmount": 13050000,"status": "T","openingPrice": 2.343072},
Sample Result - FPOsByCountry - XML
Results based on
https://app.quotemedia.com/v2/events/fpos?webmaster_id=XXXXXX&start=2021-01-01&end=2021-06-01&country=US&content_type=xml
*Results limited to show just the first few results
<results pageNumber="4" totalPages="21" nextPage="https://app.quotemedia.com/v2/events/fpos?webmaster_id=91924&start=2021-01-01&end=2021-06-01&country=US&content_type=xml&results_per_page=10&page=5" prevPage="https://app.quotemedia.com/v2/events/fpos?webmaster_id=91924&start=2021-01-01&end=2021-06-01&country=US&content_type=xml&results_per_page=10&page=3"><copyright>Copyright (c) 2022 QuoteMedia, Inc.</copyright><country>US</country><offerings><offering><offerType>FPO</offerType><listingStatus>Listed</listingStatus><useOfProceeds>All proceeds from the sale of shares of common stock under this prospectus will be for the account of the selling stockholders</useOfProceeds><dateOfFiling>2021-08-05</dateOfFiling><offerAmountMin>250000000</offerAmountMin><registrationFee>27275</registrationFee><symbol><symbol>SPNE</symbol><companyName>SeaSpine Holdings Corp</companyName><exchange>NSD</exchange><currency>USD</currency></symbol><dateOfListing>2021-04-19</dateOfListing><status>F</status><lawFirm>DLA Piper LLP</lawFirm><transferAgent>American Stock Transfer & Trust Company LLC</transferAgent><openingPrice>19.0</openingPrice></offering><offering><offerType>FPO</offerType><listingStatus>Listed</listingStatus><useOfProceeds>We intend to use the net proceeds from this offering, together with our existing cash and cash equivalents, as follows:1.the advancement of SYNB1934 into the Phase 2 SynPheny study;2.preparations for a Phase 3 clinical trial in PKU with SYNB1618 or SYNB1934; and 3.general corporate purposes.</useOfProceeds><offeringAnnouncementDate>2021-04-16</offeringAnnouncementDate><underwritingDiscount>0.18</underwritingDiscount><proceedsAfterExpenses>2.82</proceedsAfterExpenses><lockupPeriod>180</lockupPeriod><lockupExpirationDate>2022-03-22</lockupExpirationDate><quietPeriodExpirationDate>2021-11-02</quietPeriodExpirationDate><dateOfFiling>2021-07-23</dateOfFiling><offerAmountMin>45000000</offerAmountMin><registrationFee>27275</registrationFee><typeOfEquityInstrument>Common Shares</typeOfEquityInstrument><securityParvalue>0.001</securityParvalue><symbol><symbol>SYBX</symbol><companyName>Synlogic Inc</companyName><exchange>NSD</exchange><currency>USD</currency></symbol><offerPrice>3</offerPrice><priceRangeMax>3</priceRangeMax><priceRangeMin>3</priceRangeMin><sharesOffered>15000000</sharesOffered><dateOfListing>2021-04-19</dateOfListing><offerAmount>45000000</offerAmount><status>T</status><underwriter>SVB Leerink LLC,Jefferies LLC</underwriter><lawFirm>Mintz, Levin, Cohn, Ferris, Glovsky and Popeo, PC</lawFirm><transferAgent>American Stock Transfer & Trust Company LLC</transferAgent><openingPrice>50.75</openingPrice></offering><offering><offerType>FPO</offerType><offerStatus>Closed</offerStatus><listingStatus>Listed</listingStatus><lockupPeriod>180</lockupPeriod><lockupExpirationDate>2021-10-13</lockupExpirationDate><quietPeriodExpirationDate>2021-05-26</quietPeriodExpirationDate><totalOfferingExpense>555398</totalOfferingExpense><offerAmountMin>50000000</offerAmountMin><symbol><symbol>JOB</symbol><companyName>GEE Group Inc</companyName><exchange>NYE</exchange><currency>USD</currency></symbol><offerPrice>0.6</offerPrice><priceRangeMax>0.6</priceRangeMax><priceRangeMin>0.6</priceRangeMin><sharesOffered>83333333</sharesOffered><dateOfListing>2021-04-16</dateOfListing><offerAmount>49999999.8</offerAmount><status>T</status><openingPrice>5.37318</openingPrice></offering><offering><offerType>FPO</offerType><offerStatus>Closed</offerStatus><listingStatus>Listed</listingStatus><lockupPeriod>180</lockupPeriod><lockupExpirationDate>2021-10-12</lockupExpirationDate><quietPeriodExpirationDate>2021-05-25</quietPeriodExpirationDate><offerAmountMin>13050000</offerAmountMin><symbol><symbol>PHX</symbol><companyName>PHX MINERALS INC</companyName><exchange>NYE</exchange><currency>USD</currency></symbol><offerPrice>2.61</offerPrice><priceRangeMax>2.61</priceRangeMax><priceRangeMin>2.61</priceRangeMin><sharesOffered>5000000</sharesOffered><dateOfListing>2021-04-15</dateOfListing><offerAmount>13050000.00</offerAmount><status>T</status><openingPrice>2.343072</openingPrice></offering>