{"openapi":"3.1.0","info":{"title":"SC Tools Auction API","description":"Цены аукциона STALZONE. Документация: https://auction.sctools.tech/docs","version":"0.1.0"},"paths":{"/api/health":{"get":{"summary":"Health","operationId":"health_api_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/api/leaders":{"get":{"summary":"Leaders","operationId":"leaders_api_leaders_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeadersResponse"}}}}}}},"/api/search":{"get":{"summary":"Search Items","operationId":"search_items_api_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":60,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeadersResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/items/{item_id}/chart":{"get":{"summary":"Get Item Chart","operationId":"get_item_chart_api_items__item_id__chart_get","parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string","title":"Item Id"}},{"name":"qlt","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":6,"minimum":0},{"type":"null"}],"title":"Qlt"}},{"name":"ptn","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":15,"minimum":0},{"type":"null"}],"title":"Ptn"}},{"name":"lvl","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Lvl"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemChartResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/items/{item_id}/lots":{"get":{"summary":"Get Item Lots","description":"Активные лоты предмета.\n\nsort: unit — дешевле за штуку, price — дешевле по выкупу,\nnew — недавно выставленные, ending — скоро закончатся.\nЛоты без выкупа (только ставки) в сортировках по цене идут в конце.","operationId":"get_item_lots_api_items__item_id__lots_get","parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string","title":"Item Id"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","default":"unit","title":"Sort"}},{"name":"qlt","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":6,"minimum":0},{"type":"null"}],"title":"Qlt"}},{"name":"ptn","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":15,"minimum":0},{"type":"null"}],"title":"Ptn"}},{"name":"lvl","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Lvl"}},{"name":"buyout_only","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Buyout Only"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActiveLotsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/items/{item_id}":{"get":{"summary":"Get Item","operationId":"get_item_api_items__item_id__get","parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string","title":"Item Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemStatsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/prices":{"post":{"summary":"Quote Prices","operationId":"quote_prices_api_prices_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceQueryRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceQueryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/":{"get":{"summary":"Index","operationId":"index__get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}}},"components":{"schemas":{"ActiveLotOut":{"properties":{"amount":{"type":"integer","title":"Amount"},"copies":{"type":"integer","title":"Copies","default":1},"start_price":{"type":"integer","title":"Start Price"},"current_price":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Current Price"},"buyout_price":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Buyout Price"},"unit_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Unit Price"},"start_time":{"type":"string","format":"date-time","title":"Start Time"},"end_time":{"type":"string","format":"date-time","title":"End Time"},"qlt":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Qlt"},"ptn":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ptn"},"spawn_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Spawn Time"},"additional":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Additional"}},"type":"object","required":["amount","start_price","start_time","end_time"],"title":"ActiveLotOut"},"ActiveLotsResponse":{"properties":{"item_id":{"type":"string","title":"Item Id"},"name":{"type":"string","title":"Name"},"kind":{"type":"string","title":"Kind","default":"artefact"},"api_total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Api Total"},"stored":{"type":"integer","title":"Stored","default":0},"matched":{"type":"integer","title":"Matched","default":0},"synced_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Synced At"},"full_synced_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Full Synced At"},"min_unit_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Unit Price"},"lots":{"items":{"$ref":"#/components/schemas/ActiveLotOut"},"type":"array","title":"Lots"}},"type":"object","required":["item_id","name"],"title":"ActiveLotsResponse"},"BucketStats":{"properties":{"avg_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Price"},"lots_used":{"type":"integer","title":"Lots Used","default":0},"lots_month":{"type":"integer","title":"Lots Month","default":0}},"type":"object","title":"BucketStats"},"ChartPoint":{"properties":{"t":{"type":"string","format":"date-time","title":"T"},"price":{"type":"number","title":"Price"},"lots":{"type":"integer","title":"Lots","default":0}},"type":"object","required":["t","price"],"title":"ChartPoint"},"ChartSeries":{"properties":{"bucket":{"type":"string","title":"Bucket"},"points":{"items":{"$ref":"#/components/schemas/ChartPoint"},"type":"array","title":"Points"}},"type":"object","required":["bucket"],"title":"ChartSeries"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"scanner":{"type":"string","title":"Scanner"},"items_total":{"type":"integer","title":"Items Total"},"bootstrap_done":{"type":"integer","title":"Bootstrap Done"},"bootstrap_left":{"type":"integer","title":"Bootstrap Left"},"percent":{"type":"number","title":"Percent"},"lots":{"type":"integer","title":"Lots"},"ready":{"type":"boolean","title":"Ready"},"current_items":{"items":{"type":"string"},"type":"array","title":"Current Items"},"last_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error"},"limit_per_min":{"type":"integer","title":"Limit Per Min","default":350},"rpm_1m":{"type":"integer","title":"Rpm 1M","default":0},"rpm_15m":{"type":"number","title":"Rpm 15M","default":0},"rpm_1h":{"type":"number","title":"Rpm 1H","default":0},"rpm_4h":{"type":"number","title":"Rpm 4H","default":0},"rpm_24h":{"type":"number","title":"Rpm 24H","default":0},"limit_used_pct":{"type":"number","title":"Limit Used Pct","default":0},"load_pct_24h":{"type":"number","title":"Load Pct 24H","default":0},"eta_sec":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Eta Sec"},"general_total":{"type":"integer","title":"General Total","default":0},"general_on_auction":{"type":"integer","title":"General On Auction","default":0},"general_absent":{"type":"integer","title":"General Absent","default":0},"general_probe_left":{"type":"integer","title":"General Probe Left","default":0},"general_bootstrap_done":{"type":"integer","title":"General Bootstrap Done","default":0},"general_bootstrap_left":{"type":"integer","title":"General Bootstrap Left","default":0},"general_loaded":{"type":"integer","title":"General Loaded","default":0},"general_percent":{"type":"number","title":"General Percent","default":0},"general_ready":{"type":"boolean","title":"General Ready","default":false},"general_eta_sec":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"General Eta Sec"},"general_deepen_left":{"type":"integer","title":"General Deepen Left","default":0},"api_limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Api Limit"},"api_remaining":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Api Remaining"},"api_reset_in_sec":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Api Reset In Sec"},"api_reserve":{"type":"integer","title":"Api Reserve","default":0},"api_quota_waits":{"type":"integer","title":"Api Quota Waits","default":0},"active":{"additionalProperties":true,"type":"object","title":"Active"}},"type":"object","required":["status","scanner","items_total","bootstrap_done","bootstrap_left","percent","lots","ready"],"title":"HealthResponse"},"ItemChartResponse":{"properties":{"item_id":{"type":"string","title":"Item Id"},"name":{"type":"string","title":"Name"},"kind":{"type":"string","title":"Kind","default":"artefact"},"aggregation":{"type":"string","title":"Aggregation","default":"median_unit"},"qlt":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Qlt"},"ptn":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ptn"},"lvl":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Lvl"},"series":{"additionalProperties":{"$ref":"#/components/schemas/ChartSeries"},"type":"object","title":"Series"}},"type":"object","required":["item_id","name"],"title":"ItemChartResponse"},"ItemStatsResponse":{"properties":{"item_id":{"type":"string","title":"Item Id"},"name":{"type":"string","title":"Name"},"kind":{"type":"string","title":"Kind","default":"artefact"},"on_auction":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"On Auction"},"bootstrap_done":{"type":"boolean","title":"Bootstrap Done"},"last_scan_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Scan At"},"lots_per_hour":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lots Per Hour"},"keep_all_lots":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Keep All Lots"},"averages":{"additionalProperties":{"additionalProperties":{"$ref":"#/components/schemas/BucketStats"},"type":"object"},"type":"object","title":"Averages"},"medians":{"additionalProperties":{"$ref":"#/components/schemas/WindowStats"},"type":"object","title":"Medians"},"recent_lots":{"items":{"$ref":"#/components/schemas/RecentLot"},"type":"array","title":"Recent Lots"}},"type":"object","required":["item_id","name","bootstrap_done"],"title":"ItemStatsResponse"},"LeaderItem":{"properties":{"rank":{"type":"integer","title":"Rank"},"item_id":{"type":"string","title":"Item Id"},"name":{"type":"string","title":"Name"},"kind":{"type":"string","title":"Kind"},"turnover":{"type":"integer","title":"Turnover"},"lots":{"type":"integer","title":"Lots"},"units":{"type":"integer","title":"Units"}},"type":"object","required":["rank","item_id","name","kind","turnover","lots","units"],"title":"LeaderItem"},"LeadersResponse":{"properties":{"hours":{"type":"integer","title":"Hours"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"},"items":{"items":{"$ref":"#/components/schemas/LeaderItem"},"type":"array","title":"Items"}},"type":"object","required":["hours","generated_at"],"title":"LeadersResponse"},"PriceQueryItem":{"properties":{"id":{"type":"string","maxLength":32,"minLength":1,"title":"Id"},"qlt":{"type":"integer","maximum":6.0,"minimum":0.0,"title":"Qlt"},"ptn":{"type":"integer","maximum":15.0,"minimum":0.0,"title":"Ptn"}},"type":"object","required":["id","qlt","ptn"],"title":"PriceQueryItem"},"PriceQueryRequest":{"properties":{"items":{"items":{"$ref":"#/components/schemas/PriceQueryItem"},"type":"array","maxItems":100,"minItems":1,"title":"Items"}},"type":"object","required":["items"],"title":"PriceQueryRequest"},"PriceQueryResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/PriceResultItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"PriceQueryResponse"},"PriceResultItem":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"qlt":{"type":"integer","title":"Qlt"},"ptn":{"type":"integer","title":"Ptn"},"ptn_bucket":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ptn Bucket"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Price"},"lots_used":{"type":"integer","title":"Lots Used","default":0},"lots_month":{"type":"integer","title":"Lots Month","default":0},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["id","name","qlt","ptn"],"title":"PriceResultItem"},"RecentLot":{"properties":{"t":{"type":"string","format":"date-time","title":"T"},"amount":{"type":"integer","title":"Amount"},"price":{"type":"integer","title":"Price"},"unit_price":{"type":"number","title":"Unit Price"},"qlt":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Qlt"},"ptn":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ptn"},"spawn_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Spawn Time"},"upgrade_bonus":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Upgrade Bonus"}},"type":"object","required":["t","amount","price","unit_price"],"title":"RecentLot"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"WindowStats":{"properties":{"avg_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Price"},"lots":{"type":"integer","title":"Lots","default":0}},"type":"object","title":"WindowStats"}}}}