A diff between this client library's spec and our hosted spec was found. The client may need an update to match any changes in our API. See the diff below:
--- https://raw.githubusercontent.com/polygon-io/client-python/master/.polygon/rest.json
+++ https://api.polygon.io/openapi
@@ -63,7 +63,7 @@
},
"AggregateTimeTo": {
"description": "The end of the aggregate time window. Either a date with the format YYYY-MM-DD or a millisecond timestamp.",
- "example": "2023-01-09",
+ "example": "2023-02-10",
"in": "path",
"name": "to",
"required": true,
@@ -153,7 +153,7 @@
},
"IndicesAggregateTimeFrom": {
"description": "The start of the aggregate time window. Either a date with the format YYYY-MM-DD or a millisecond timestamp.",
- "example": "2023-03-10",
+ "example": "2023-03-13",
"in": "path",
"name": "from",
"required": true,
@@ -163,7 +163,7 @@
},
"IndicesAggregateTimeTo": {
"description": "The end of the aggregate time window. Either a date with the format YYYY-MM-DD or a millisecond timestamp.",
- "example": "2023-03-10",
+ "example": "2023-03-24",
"in": "path",
"name": "to",
"required": true,
@@ -13911,8 +13911,7 @@
"files_count",
"source_url",
"download_url",
- "entities",
- "acceptance_datetime"
+ "entities"
],
"type": "object",
"x-polygon-go-type": {
@@ -13982,121 +13981,125 @@
"example": {},
"schema": {
"properties": {
- "acceptance_datetime": {
- "description": "The datetime when the filing was accepted by EDGAR in EST (format: YYYYMMDDHHMMSS)",
- "type": "string"
- },
- "accession_number": {
- "description": "Filing Accession Number",
- "type": "string"
- },
- "entities": {
- "description": "Entities related to the filing (e.g. the document filers).",
- "items": {
- "description": "A filing entity (e.g. the document filer).",
- "properties": {
- "company_data": {
+ "results": {
+ "properties": {
+ "acceptance_datetime": {
+ "description": "The datetime when the filing was accepted by EDGAR in EST (format: YYYYMMDDHHMMSS)",
+ "type": "string"
+ },
+ "accession_number": {
+ "description": "Filing Accession Number",
+ "type": "string"
+ },
+ "entities": {
+ "description": "Entities related to the filing (e.g. the document filers).",
+ "items": {
+ "description": "A filing entity (e.g. the document filer).",
"properties": {
- "cik": {
- "description": "Central Index Key (CIK) Number",
- "type": "string"
+ "company_data": {
+ "properties": {
+ "cik": {
+ "description": "Central Index Key (CIK) Number",
+ "type": "string"
+ },
+ "name": {
+ "example": "Facebook Inc",
+ "type": "string"
+ },
+ "sic": {
+ "description": "Standard Industrial Classification (SIC)",
+ "type": "string"
+ },
+ "ticker": {
+ "description": "Ticker",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "cik",
+ "sic"
+ ],
+ "type": "object",
+ "x-polygon-go-type": {
+ "name": "SECCompanyData",
+ "path": "github.com/polygon-io/go-lib-models/v2/globals"
+ }
},
- "name": {
- "example": "Facebook Inc",
+ "relation": {
+ "description": "Relationship of this entity to the filing.",
+ "enum": [
+ "filer"
+ ],
"type": "string"
- },
- "sic": {
- "description": "Standard Industrial Classification (SIC)",
- "type": "string"
- },
- "ticker": {
- "description": "Ticker",
- "type": "string"
}
},
"required": [
- "name",
- "cik",
- "sic"
+ "relation"
],
"type": "object",
"x-polygon-go-type": {
- "name": "SECCompanyData",
+ "name": "SECFilingEntity",
"path": "github.com/polygon-io/go-lib-models/v2/globals"
}
},
- "relation": {
- "description": "Relationship of this entity to the filing.",
- "enum": [
- "filer"
- ],
- "type": "string"
- }
+ "type": "array"
},
- "required": [
- "relation"
- ],
- "type": "object",
- "x-polygon-go-type": {
- "name": "SECFilingEntity",
- "path": "github.com/polygon-io/go-lib-models/v2/globals"
+ "files_count": {
+ "description": "The number of files associated with the filing.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "filing_date": {
+ "description": "The date when the filing was filed in YYYYMMDD format.",
+ "example": "20210101",
+ "pattern": "^[0-9]{8}$",
+ "type": "string"
+ },
+ "id": {
+ "description": "Unique identifier for the filing.",
+ "type": "string"
+ },
+ "period_of_report_date": {
+ "description": "The period of report for the filing in YYYYMMDD format.",
+ "example": "20210101",
+ "pattern": "^[0-9]{8}$",
+ "type": "string"
+ },
+ "source_url": {
+ "description": "The source URL is a link back to the upstream source for this filing\ndocument.",
+ "example": "https://www.sec.gov/Archives/edgar/data/0001326801/000132680119000037/0001326801-19-000037-index.html",
+ "format": "uri",
+ "type": "string"
+ },
+ "type": {
+ "description": "Filing Type",
+ "enum": [
+ "10-K",
+ "10-Q"
+ ],
+ "type": "string"
}
},
- "type": "array"
- },
- "files_count": {
- "description": "The number of files associated with the filing.",
- "format": "int64",
- "type": "integer"
- },
- "filing_date": {
- "description": "The date when the filing was filed in YYYYMMDD format.",
- "example": "20210101",
- "pattern": "^[0-9]{8}$",
- "type": "string"
- },
- "id": {
- "description": "Unique identifier for the filing.",
- "type": "string"
- },
- "period_of_report_date": {
- "description": "The period of report for the filing in YYYYMMDD format.",
- "example": "20210101",
- "pattern": "^[0-9]{8}$",
- "type": "string"
- },
- "source_url": {
- "description": "The source URL is a link back to the upstream source for this filing\ndocument.",
- "example": "https://www.sec.gov/Archives/edgar/data/0001326801/000132680119000037/0001326801-19-000037-index.html",
- "format": "uri",
- "type": "string"
- },
- "type": {
- "description": "Filing Type",
- "enum": [
- "10-K",
- "10-Q"
+ "required": [
+ "id",
+ "accession_number",
+ "type",
+ "filing_date",
+ "period_of_report_date",
+ "files_count",
+ "source_url",
+ "download_url",
+ "entities"
],
- "type": "string"
+ "type": "object",
+ "x-polygon-go-type": {
+ "name": "SECFiling",
+ "path": "github.com/polygon-io/go-lib-models/v2/globals"
+ }
}
},
- "required": [
- "id",
- "accession_number",
- "type",
- "filing_date",
- "period_of_report_date",
- "files_count",
- "source_url",
- "download_url",
- "entities",
- "acceptance_datetime"
- ],
- "type": "object",
- "x-polygon-go-type": {
- "name": "SECFiling",
- "path": "github.com/polygon-io/go-lib-models/v2/globals"
- }
+ "type": "object"
}
}
},
@@ -15711,7 +15696,7 @@
},
{
"description": "The end of the aggregate time window. Either a date with the format YYYY-MM-DD or a millisecond timestamp.",
- "example": "2023-01-09",
+ "example": "2023-02-10",
"in": "path",
"name": "to",
"required": true,
@@ -16164,7 +16149,7 @@
},
{
"description": "The end of the aggregate time window. Either a date with the format YYYY-MM-DD or a millisecond timestamp.",
- "example": "2023-01-09",
+ "example": "2023-02-10",
"in": "path",
"name": "to",
"required": true,
@@ -16560,7 +16545,7 @@
},
{
"description": "The start of the aggregate time window. Either a date with the format YYYY-MM-DD or a millisecond timestamp.",
- "example": "2023-03-10",
+ "example": "2023-03-13",
"in": "path",
"name": "from",
"required": true,
@@ -16570,7 +16555,7 @@
},
{
"description": "The end of the aggregate time window. Either a date with the format YYYY-MM-DD or a millisecond timestamp.",
- "example": "2023-03-10",
+ "example": "2023-03-24",
"in": "path",
"name": "to",
"required": true,
@@ -16983,7 +16968,7 @@
},
{
"description": "The end of the aggregate time window. Either a date with the format YYYY-MM-DD or a millisecond timestamp.",
- "example": "2023-01-09",
+ "example": "2023-02-10",
"in": "path",
"name": "to",
"required": true,
@@ -17431,7 +17416,7 @@
},
{
"description": "The end of the aggregate time window. Either a date with the format YYYY-MM-DD or a millisecond timestamp.",
- "example": "2023-01-09",
+ "example": "2023-02-10",
"in": "path",
"name": "to",
"required": true,
@@ -22882,6 +22867,8 @@
},
"x-polygon-paginate": {
"limit": {
+ "default": 10,
+ "example": 10,
"max": 50000
},
"order": {
@@ -23129,6 +23116,8 @@
},
"x-polygon-paginate": {
"limit": {
+ "default": 10,
+ "example": 10,
"max": 50000
},
"order": {
@@ -23430,6 +23419,8 @@
},
"x-polygon-paginate": {
"limit": {
+ "default": 10,
+ "example": 10,
"max": 50000
},
"order": {
@@ -25395,7 +25386,7 @@
"parameters": [
{
"description": "Query for a contract by options ticker. You can learn more about the structure of options tickers [here](https://polygon.io/blog/how-to-read-a-stock-options-ticker/).",
- "example": "O:EVRI240119C00002500",
+ "example": "O:SPY251219C00650000",
"in": "path",
"name": "options_ticker",
"required": true,
@@ -29104,6 +29095,8 @@
},
"x-polygon-paginate": {
"limit": {
+ "default": 10,
+ "example": 10,
"max": 50000
},
"order": {
@@ -29356,6 +29349,8 @@
},
"x-polygon-paginate": {
"limit": {
+ "default": 10,
+ "example": 10,
"max": 50000
},
"order": {
@@ -29645,6 +29640,8 @@
},
"x-polygon-paginate": {
"limit": {
+ "default": 10,
+ "example": 10,
"max": 50000
},
"order": {
@@ -30499,7 +30496,7 @@
"type": "string"
},
"tag": {
- "description": "A specific type within a category. For example \u201cproduct_sales\u201d is a type of revenue stream. A company may have multiple tags within a given category. A taxonomy of tags are determined based on 10k filings.",
+ "description": "A specific type within a category. For example “product_sales” is a type of revenue stream. A company may have multiple tags within a given category. A taxonomy of tags are determined based on 10k filings.",
"type": "string"
},
"ticker": {
justinpolygon
commented
5 months ago
A diff between this client library's spec and our hosted spec was found. The client may need an update to match any changes in our API. See the diff below: