{"openapi":"3.1.0","info":{"title":"MarketParquet API","version":"1","description":"Historical US stock, ETF and futures OHLCV in Parquet, one file per trading day. Authenticate with `Authorization: Bearer bt_...` (create a key at https://marketparquet.com/account). Start at GET /api/v1/ for a plain-JSON map of the endpoints."},"servers":[{"url":"https://marketparquet.com"}],"paths":{"/api/v1/assets":{"get":{"tags":["api-v1"],"summary":"List Assets","description":"List all available asset types, timeframes, and their stats.","operationId":"list_assets_api_v1_assets_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"access_token","in":"cookie","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Access Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/dates/{asset_type}":{"get":{"tags":["api-v1"],"summary":"List Dates","description":"List available dates for an asset type.\n\nReturns up to 100 dates per page, newest first.\nDates outside your plan's access window are excluded.","operationId":"list_dates_api_v1_dates__asset_type__get","parameters":[{"name":"asset_type","in":"path","required":true,"schema":{"type":"string","title":"Asset Type"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"access_token","in":"cookie","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Access Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/download/{asset_type}/{date_str}":{"get":{"tags":["api-v1"],"summary":"Download File","description":"Get a presigned download URL for a specific file.\n\nReturns a JSON object with the presigned URL (valid for 60 seconds).\nUse the URL to download the parquet file directly from storage.","operationId":"download_file_api_v1_download__asset_type___date_str__get","parameters":[{"name":"asset_type","in":"path","required":true,"schema":{"type":"string","title":"Asset Type"}},{"name":"date_str","in":"path","required":true,"schema":{"type":"string","title":"Date Str"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"access_token","in":"cookie","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Access Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/manifest/{asset_type}":{"get":{"tags":["api-v1"],"summary":"Download Manifest","description":"Presigned URLs for every file of one asset type in [start, end].\n\nOne request per date range instead of one per file. URLs are valid for\n3600 seconds. Up to 400 files per call, so walk longer ranges in\nconsecutive chunks (one calendar year of any timeframe fits). Counts as a\nsingle request against the rate limit; each file is logged as a download.","operationId":"download_manifest_api_v1_manifest__asset_type__get","parameters":[{"name":"asset_type","in":"path","required":true,"schema":{"type":"string","title":"Asset Type"}},{"name":"start","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start"}},{"name":"end","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"access_token","in":"cookie","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Access Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"}},"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}]}