{"openapi":"3.0.0","info":{"title":"Master Panel Market Data API","version":"1.1.0","description":"BUFF-compatible cached market replicas. Not affiliated with BUFF unless authorized."},"servers":[{"url":"https://buff-api.masterspanel.com"}],"paths":{"/v1/health":{"get":{"summary":"Health","responses":{"200":{"description":"OK"}}}},"/v1/usage":{"get":{"summary":"Live quota usage for the calling key","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Current usage, limits, and reset times","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Request IP not in the key allowlist (ip_not_allowed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/buff/enterprise/items":{"get":{"summary":"enterprise_items_cs2_no_sticker","security":[{"bearerAuth":[]}],"parameters":[{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag from a previous response; matching returns 304 with zero bandwidth cost"}],"responses":{"200":{"description":"Buff-compatible snapshot JSON","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotResponse"}}},"headers":{"ETag":{"description":"Snapshot version; send back via If-None-Match","schema":{"type":"string"}},"X-Cache-Age":{"description":"Seconds since snapshot was published","schema":{"type":"integer"}}}},"304":{"description":"Not modified (If-None-Match matched). Costs 0 bytes of monthly bandwidth."},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Request IP not in the key allowlist (ip_not_allowed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Quota exceeded: rpm_limit, rpd_limit, concurrent_limit, or bandwidth_limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Snapshot temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/buff/enterprise/float/items":{"get":{"summary":"enterprise_float_items_cs2_no_sticker","security":[{"bearerAuth":[]}],"parameters":[{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag from a previous response; matching returns 304 with zero bandwidth cost"}],"responses":{"200":{"description":"Buff-compatible snapshot JSON","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotResponse"}}},"headers":{"ETag":{"description":"Snapshot version; send back via If-None-Match","schema":{"type":"string"}},"X-Cache-Age":{"description":"Seconds since snapshot was published","schema":{"type":"integer"}}}},"304":{"description":"Not modified (If-None-Match matched). Costs 0 bytes of monthly bandwidth."},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Request IP not in the key allowlist (ip_not_allowed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Quota exceeded: rpm_limit, rpd_limit, concurrent_limit, or bandwidth_limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Snapshot temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/buff/enterprise/items/liquidity-rank":{"get":{"summary":"enterprise_liquidity_rank_cs2","security":[{"bearerAuth":[]}],"parameters":[{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag from a previous response; matching returns 304 with zero bandwidth cost"}],"responses":{"200":{"description":"Buff-compatible snapshot JSON","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotResponse"}}},"headers":{"ETag":{"description":"Snapshot version; send back via If-None-Match","schema":{"type":"string"}},"X-Cache-Age":{"description":"Seconds since snapshot was published","schema":{"type":"integer"}}}},"304":{"description":"Not modified (If-None-Match matched). Costs 0 bytes of monthly bandwidth."},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Request IP not in the key allowlist (ip_not_allowed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Quota exceeded: rpm_limit, rpd_limit, concurrent_limit, or bandwidth_limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Snapshot temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]},"SaleEntry":{"type":"object","description":"Price entry. Prices are decimal strings in CNY (e.g. \"1520.5\").","properties":{"min_price":{"type":"string","example":"1520.5"},"buy_max_price":{"type":"string","example":"1480"}}},"SnapshotItem":{"type":"object","properties":{"goods_id":{"type":"integer","example":35894},"market_hash_name":{"type":"string","example":"AK-47 | Redline (Field-Tested)"},"name":{"type":"string"},"update_time":{"type":"integer","description":"Unix seconds of last upstream update"},"sales":{"type":"array","items":{"$ref":"#/components/schemas/SaleEntry"}}}},"SnapshotResponse":{"type":"object","properties":{"stat_time":{"type":"integer","description":"Unix seconds when the snapshot was generated"},"info":{"type":"array","items":{"$ref":"#/components/schemas/SnapshotItem"}}}},"UsageResponse":{"type":"object","properties":{"limits":{"type":"object","properties":{"rpm":{"type":"integer","example":20},"rpd":{"type":"integer","example":2000},"concurrent":{"type":"integer","example":2},"monthlyBytes":{"type":"integer","example":53687091200}}},"used":{"type":"object","properties":{"rpm":{"type":"integer"},"rpd":{"type":"integer"},"monthlyBytes":{"type":"integer"}}},"remaining":{"type":"object","properties":{"rpm":{"type":"integer"},"rpd":{"type":"integer"},"monthlyBytes":{"type":"integer"}}},"resets":{"type":"object","properties":{"rpmSeconds":{"type":"integer"},"rpdAt":{"type":"string","format":"date-time"},"bytesAt":{"type":"string","format":"date-time"}}},"key":{"type":"object","properties":{"prefix":{"type":"string","example":"bapi_live_bhX78m"},"periodEnd":{"type":"string","format":"date-time","nullable":true},"allowedIps":{"type":"array","items":{"type":"string"}}}}}}}}}