{"openapi":"3.1.0","info":{"title":"Talon API","version":"2.0.0","description":"Talon is an SMM panel that publishes its prices. `/api/v2` is the PerfectPanel-compatible reseller API (create orders, read status, read balance); `/api/public/services` is the keyless catalogue that comparison directories read; `/api/public/price` answers one product family with the cheapest, median and per-panel rates this panel publishes. Rates are US dollars per 1,000 units, the unit every SMM panel quotes.","contact":{"url":"https://talonpanel.com/api-docs","email":"support@talonpanel.com"},"license":{"name":"API terms","url":"https://talonpanel.com/terms"}},"servers":[{"url":"https://talonpanel.com"}],"tags":[{"name":"reseller","description":"Order API (key required)"},{"name":"catalogue","description":"Keyless read-only catalogue"},{"name":"market","description":"Public price index"}],"paths":{"/api/v2":{"post":{"tags":["reseller"],"operationId":"v2Action","summary":"One call, one action: services, add, status, cancel, refill, balance","requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","required":["key","action"],"properties":{"key":{"type":"string","description":"Account API key (kt_...)"},"action":{"type":"string","enum":["services","add","status","cancel","refill","balance"]},"service":{"type":"integer"},"link":{"type":"string","format":"uri"},"quantity":{"type":"integer"},"order":{"type":"integer","description":"For status/cancel/refill"},"orders":{"type":"string","description":"Comma-separated order ids"}}}}}},"responses":{"200":{"description":"Action result. An action error still answers 200 with `error` and `error_code`, which is what reseller panels parse."},"401":{"description":"Unknown API key (`API_KEY_INVALID`)"},"429":{"description":"Rate limited; `retry_after` in seconds"}}}},"/api/public/services":{"get":{"tags":["catalogue"],"operationId":"publicServices","summary":"The catalogue, no key, no balance, no ordering","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","schema":{"type":"integer","default":100,"maximum":500}},{"name":"skip","in":"query","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"A page of services in the v2 shape","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"service":{"type":"integer","description":"Stable service id"},"name":{"type":"string"},"type":{"type":"string","example":"Default"},"category":{"type":"string"},"rate":{"type":"string","description":"USD per 1,000 units, four decimals"},"min":{"type":"integer"},"max":{"type":"integer"},"refill":{"type":"boolean"},"cancel":{"type":"boolean"},"dripfeed":{"type":"boolean"}}}}}}}}}},"/api/public/price":{"get":{"tags":["market"],"operationId":"publicPrice","summary":"Cheapest, median and Talon's own rate for one product family","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","example":"instagram-followers"},"description":"Family slug, product slug, or a service name"}],"responses":{"200":{"description":"Family summary plus the panels that sell it","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Missing `q`"},"429":{"description":"Public rate limit reached"}}}},"/api/v1/price":{"get":{"tags":["market"],"operationId":"v1Price","summary":"The same price lookup on the keyed data API","security":[{"apiKey":[]}],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"currency","in":"query","schema":{"type":"string","default":"USD"}}],"responses":{"200":{"description":"Price with the dated exchange rate used"},"401":{"description":"Missing or invalid key"},"503":{"description":"No dated FX rate for that currency"}}}},"/api/v1/index":{"get":{"tags":["market"],"operationId":"v1Index","summary":"The whole index in one call","security":[{"apiKey":[]}],"responses":{"200":{"description":"Every family with its cheapest, median and Talon rate"},"401":{"description":"Missing or invalid key"}}}}},"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"query","name":"key","description":"Data API key; create one at /api-docs"}}},"externalDocs":{"url":"https://talonpanel.com/api-docs","description":"Human-readable API guide and sandbox key"}}