# Twitch Economy API Reference Canonical: https://monsterapi.co/docs/api/twitch-economy Read the Twitch Economy reference. Review parameters, response fields, examples, and current credit prices. OpenAPI specification: [Twitch](https://monsterapi.co/docs/openapi/platforms/twitch.yaml). --- Current operation prices: [public catalog](https://monsterapi.co/account/api/v1/public/api-prices). Prices use credits per request. --- # Twitch: Charity campaign `GET /twitch/api/channel/{login}/charity` Documentation: https://monsterapi.co/docs/api/twitch#charity-campaign Operation ID: `twitch_channel_charity` Returns the identifier of one channel’s active charity campaign. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). ## Responses - 200: Fundraiser state - 400: bad_request: invalid path or query parameter Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: requested resource does not exist or is unavailable - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/channel/{login}/charity' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Channel goals `GET /twitch/api/channel/{login}/goals` Documentation: https://monsterapi.co/docs/api/twitch#channel-goals Operation ID: `twitch_channel_goals` Returns a channel’s goals, including their contribution type, state, current value and target. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). ## Responses - 200: Goals of the channel - 400: bad_request: invalid path or query parameter Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: resource absent or all primary lists are empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/channel/{login}/goals' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Channel leaderboards `GET /twitch/api/channel/{login}/leaderboard` Documentation: https://monsterapi.co/docs/api/twitch#channel-leaderboards Operation ID: `twitch_channel_leaderboard` Returns the bits, gifted subscription and clip leaderboards of one channel for the period Twitch selects. Disabled tables are null. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). ## Responses - 200: Leaderboards of the channel - 400: bad_request: invalid path or query parameter Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: requested resource does not exist or is unavailable - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/channel/{login}/leaderboard' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Viewable poll `GET /twitch/api/channel/{login}/poll` Documentation: https://monsterapi.co/docs/api/twitch#viewable-poll Operation ID: `twitch_channel_poll` Returns the poll Twitch currently shows for one channel. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). ## Responses - 200: Viewable poll - 400: bad_request: invalid path or query parameter Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: requested resource does not exist or is unavailable - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/channel/{login}/poll' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Channel predictions `GET /twitch/api/channel/{login}/predictions` Documentation: https://monsterapi.co/docs/api/twitch#channel-predictions Operation ID: `twitch_channel_predictions` Returns the predictions of one channel, split into the ones taking stakes, the locked ones and the resolved ones. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). ## Responses - 200: Predictions of the channel - 400: bad_request: invalid path or query parameter Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: requested resource does not exist or is unavailable - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/channel/{login}/predictions' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Channel Points rewards `GET /twitch/api/channel/{login}/rewards` Documentation: https://monsterapi.co/docs/api/twitch#channel-points-rewards Operation ID: `twitch_channel_rewards` Returns custom and automatic reward settings and point costs for one channel. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). ## Responses - 200: Rewards of the channel - 400: bad_request: invalid path or query parameter Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: requested resource does not exist or is unavailable - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/channel/{login}/rewards' \ -H 'Authorization: Bearer ' ```