{ "opencollection": "1.0.0", "info": { "name": "Factset Analytics Datastore About Shares API", "version": "1.0.0" }, "request": { "auth": { "type": "basic", "username": "{{username}}", "password": "{{password}}" } }, "items": [ { "info": { "name": "Shares", "type": "folder" }, "items": [ { "info": { "name": "Factset Gets Shares Outstanding Information for Securities.", "type": "http" }, "http": { "method": "GET", "url": "https://api.factset.com/factset-global-prices/v1/security-shares", "params": [ { "name": "ids", "value": "", "type": "query", "description": "The requested list of security identifiers. Accepted ID types include Market Tickers, SEDOL, ISINs, CUSIPs, or FactSet Permanent Ids.

***ids limit** = 500 per non-batch request / 1000 per batch request for a single day and 50 per multi-day request*

*

Make note, GET Method URL request lines are also limited to a total length of 8192 bytes (8KB). In cases where the service allows for thousands of ids, which may lead to exceeding this request line limit of 8KB, it's advised for any requests with large request lines to be requested through the respective \"POST\" method.

*" }, { "name": "startDate", "value": "2021-08-27", "type": "query", "description": "The start date requested for a given date range in **YYYY-MM-DD** format. The input start date must be before the input end date. Future dates (T+1) are not accepted in this endpoint.\n" }, { "name": "endDate", "value": "2021-08-27", "type": "query", "description": "The end date requested for a given date range in **YYYY-MM-DD** format. The input end date must be after the input start date. Future dates (T+1) are not accepted in this endpoint.\n" }, { "name": "frequency", "value": "", "type": "query", "description": "Controls the display frequency of the data returned.\n * **D** = Daily\n * **AD** = Actual Daily\n * **W** = Weekly, based on the last day of the week of the start date.\n * **M** = Monthly, based on the last trading day of the month.\n * **AM** = Monthly, based on the start date (e.g., if the start date is June 16, data is displayed for June 16, May 16, April 16 etc.).\n * **AQ** = Actual Quarterly\n * **CQ** = Quarterly based on the last trading day of the calendar quarter (March, June, September, or December).\n * **ASA** = Actual Semi-annual\n * **CSA** = Calendar Semi-annual\n * **AY** = Actual Annual, based on the start date.\n * **CY** = Calendar Annual, based on the last trading day of the calendar year.\n \n" }, { "name": "calendar", "value": "FIVEDAY", "type": "query", "description": "Calendar of data returned. SEVENDAY includes weekends." }, { "name": "batch", "value": "", "type": "query", "description": "Enables the ability to asynchronously \"batch\" the request, supporting a long-running request for up to 20 minutes. Upon requesting batch=Y, the service will respond with an HTTP Status Code of 202.\nOnce a batch request is submitted, use batch status to see if the job has been completed. Once completed, retrieve the results of the request via batch-result. When using Batch, ids limit is increased to 10000 ids per request, though limits on query string via GET method still apply. It's advised to submit large lists of ids via POST method.\nPlease note that the number of unique currencies present in the requested ids is limited to 50 per request.\n" } ] }, "docs": "Returns security level shares outstanding data for the given ids and dates. At this time, all values returned are split adjusted." }, { "info": { "name": "Factset Gets Shares Outstanding Information for Securities.", "type": "http" }, "http": { "method": "POST", "url": "https://api.factset.com/factset-global-prices/v1/security-shares", "body": { "type": "json", "data": "{}" } }, "docs": "Returns security level shares outstanding data for the given ids and dates. At this time, all values returned are split adjusted." }, { "info": { "name": "Factset Gets Shares for a List of `ids` as of Given Date Range.", "type": "http" }, "http": { "method": "GET", "url": "https://api.factset.com/factset-prices/v1/shares", "params": [ { "name": "ids", "value": "", "type": "query", "description": "The requested list of security identifiers. Accepted ID types include Market Tickers, SEDOL, ISINs, CUSIPs, or FactSet Permanent Ids.

***ids limit** = 1000 per request*

*

Make note, GET Method URL request lines are also limited to a total length of 8192 bytes (8KB). In cases where the service allows for thousands of ids, which may lead to exceeding this request line limit of 8KB, its advised for any requests with large request lines to be requested through the respective \"POST\" method.

*" }, { "name": "startDate", "value": "2019-01-01", "type": "query", "description": "The start date requested for a given date range in **YYYY-MM-DD** format. If left blank, the API will default to previous close. Future dates (T+1) are not accepted in this endpoint.\n" }, { "name": "endDate", "value": "2019-12-31", "type": "query", "description": "The end date requested for a given date range in **YYYY-MM-DD** format. If left blank, the API will default to previous close. Future dates (T+1) are not accepted in this endpoint.\n" }, { "name": "frequency", "value": "", "type": "query", "description": "Controls the display frequency of the data returned.\n * **D** = Daily\n * **W** = Weekly, based on the last day of the week of the start date.\n * **M** = Monthly, based on the last trading day of the month.\n * **AM** = Monthly, based on the start date (e.g., if the start date is June 16, data is displayed for June 16, May 16, April 16 etc.).\n * **CQ** = Quarterly based on the last trading day of the calendar quarter (March, June, September, or December).\n * **FQ** = Fiscal Quarter of the company.\n * **AY** = Actual Annual, based on the start date.\n * **CY** = Calendar Annual, based on the last trading day of the calendar year.\n * **FY** = Fiscal Annual, based on the last trading day of the company's fiscal year.\n" }, { "name": "calendar", "value": "FIVEDAY", "type": "query", "description": "Calendar of data returned. SEVENDAY includes weekends. LOCAL calendar will default to the securities' trading calendar which excludes date records for respective holiday periods." }, { "name": "splitAdjust", "value": "", "type": "query", "description": "Code to control split adjustments for shares count." } ] }, "docs": "Gets security shares for a list of 'ids' and given date range. Share values returned include security-level and company-level." }, { "info": { "name": "Factset Requests Shares for a List of `ids` as of Given Date Range.", "type": "http" }, "http": { "method": "POST", "url": "https://api.factset.com/factset-prices/v1/shares", "body": { "type": "json", "data": "{}" } }, "docs": "Gets security shares for a list of 'ids' and given date range. Share values returned include security-level and company-level." } ] } ], "bundled": true }