stake.com-api — Unofficial GraphQL API Documentation + Telegram Bot

Stake API Telegram Bot Python License

Up-to-date documentation of the Stake.com GraphQL API. Balance · Bets · Withdrawals · Tips · Sessions · KYC · Highrollers

Try Telegram Bot · Star this repo · Report Issue

GitHub stars GitHub forks

Telegram Bot — @stakecontrolbot

Table of Contents

What is the Stake.com API?

POST https://stake.com/_api/graphql

Authentication

Getting your API Key

Required Headers

POST https://stake.com/_api/graphql
Content-Type: application/json
x-access-token: YOUR_API_TOKEN

Quick Start

Python

import requests
API_KEY = "your_api_key_here"
ENDPOINT = "https://stake.com/_api/graphql"
headers = {
 "content-type": "application/json",
 "x-access-token": API_KEY,
 "origin": "https://stake.com",
 "referer": "https://stake.com/",
}
query = """
query UserBalances {
 user {
 id
 balances {
 available { amount currency }
 vault { amount currency }
 }
 }
}
"""
response = requests.post(ENDPOINT, headers=headers, json={"query": query})
data = response.json()
for b in data["data"]["user"]["balances"]:
 print(f"{b['available']['currency'].upper()}: {b['available']['amount']}")

JavaScript / Node.js

const API_KEY = "your_api_key_here";
const ENDPOINT = "https://stake.com/_api/graphql";
const query = `
 query UserBalances {
 user {
 balances {
 available { amount currency }
 }
 }
 }
`;
const res = await fetch(ENDPOINT, {
 method: "POST",
 headers: {
 "content-type": "application/json",
 "x-access-token": API_KEY,
 },
 body: JSON.stringify({ query }),
});
const { data } = await res.json();
console.log(data.user.balances);

All API Methods

Queries (read-only)

Mutations (write operations)

GraphQL Queries Reference

UserBalances

query UserBalances {
 user {
 id
 balances {
 available { amount currency }
 vault { amount currency }
 }
 }
}

CurrencyConversionRate

query CurrencyConversionRate {
 info {
 currencies {
 name
 usd: value(fiatCurrency: usd)
 eur: value(fiatCurrency: eur)
 rub: value(fiatCurrency: rub)
 }
 }
}

UserKycInfo

query UserKycInfo {
 user {
 id
 kycStatus
 hasEmailVerified
 isBanned
 isSuspended
 kycBasic {
 status
 firstName
 lastName
 country
 city
 birthday
 }
 }
}

SendTipMeta — lookup user before tipping

query SendTipMeta($name: String) {
 user(name: $name) {
 id
 name
 }
 self: user {
 id
 balances {
 available { amount currency }
 }
 }
}

TipLimit

query TipLimit($currency: CurrencyEnum!) {
 info {
 currency(currency: $currency) {
 tipMin { value }
 }
 }
}

SendTip

mutation SendTip(
 $userId: String!
 $amount: Float!
 $currency: CurrencyEnum!
 $isPublic: Boolean
 $chatId: String!
 $tfaToken: String
) {
 sendTip(
 userId: $userId
 amount: $amount
 currency: $currency
 isPublic: $isPublic
 chatId: $chatId
 tfaToken: $tfaToken
 ) {
 id
 amount
 currency
 user { id name }
 sendBy {
 id
 name
 balances {
 available { amount currency }
 }
 }
 }
}

{
 "userId": "target-user-uuid",
 "amount": 0.001,
 "currency": "btc",
 "isPublic": true,
 "chatId": "c65b4f32-0001-4e1d-9cd6-e4b3538b43ae"
}

CreateWithdrawalMeta — fees and minimums

query CreateWithdrawalMeta {
 user {
 id
 hasTfaEnabled
 balances {
 available { amount currency }
 vault { amount currency }
 }
 }
 info {
 currencies {
 name
 withdrawalFee { value }
 withdrawalMin { value }
 }
 }
}

CreateWithdrawal

mutation CreateWithdrawal(
 $currency: CryptoCurrencyEnum!
 $address: String!
 $amount: Float!
 $chain: CryptoChainEnum
 $emailCode: String
 $tfaToken: String
) {
 createWithdrawal(
 currency: $currency
 address: $address
 amount: $amount
 chain: $chain
 emailCode: $emailCode
 tfaToken: $tfaToken
 ) {
 id
 }
}

{
 "currency": "btc",
 "address": "bc1q...",
 "amount": 0.001,
 "emailCode": "123456",
 "tfaToken": "654321"
}

SessionList

query SessionList($offset: Int = 0, $limit: Int = 10) {
 user {
 id
 sessionList(offset: $offset, limit: $limit) {
 id
 sessionName
 ip
 country
 city
 active
 updatedAt
 }
 }
}

TerminateSession

mutation TerminateSession($sessionId: String!) {
 terminateSession(sessionId: $sessionId) {
 id
 sessionName
 active
 }
}

UserApiKeys

query UserApiKeys {
 user {
 id
 apiKeys {
 id
 ip
 active
 sessionName
 type
 createdAt
 updatedAt
 }
 }
}

Sport Bet History

query UserBetHistory($limit: Int, $offset: Int) {
 user {
 sportBetList(limit: $limit, offset: $offset) {
 id
 bet {
 ... on SportBet {
 amount
 currency
 status
 payout
 payoutMultiplier
 outcomes {
 odds
 status
 outcome { name payout }
 fixture {
 name
 tournament {
 category {
 sport { name slug }
 }
 }
 }
 }
 }
 }
 }
 }
}

Code Examples

Python — Reusable client class

import requests
from typing import Optional
class StakeClient:
 ENDPOINT = "https://stake.com/_api/graphql"
 def __init__(self, api_key: str):
 self.session = requests.Session()
 self.session.headers.update({
 "content-type": "application/json",
 "x-access-token": api_key,
 "origin": "https://stake.com",
 "referer": "https://stake.com/",
 "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
 })
 def _request(self, query: str, variables: dict = None, operation: str = None) -> dict:
 payload = {"query": query}
 if variables:
 payload["variables"] = variables
 if operation:
 payload["operationName"] = operation
 r = self.session.post(self.ENDPOINT, json=payload)
 r.raise_for_status()
 return r.json()
 def get_balances(self) -> dict:
 return self._request("""
 query UserBalances {
 user {
 balances {
 available { amount currency }
 vault { amount currency }
 }
 }
 }
 """, operation="UserBalances")
 def get_exchange_rates(self) -> dict:
 return self._request("""
 query CurrencyConversionRate {
 info {
 currencies {
 name
 usd: value(fiatCurrency: usd)
 eur: value(fiatCurrency: eur)
 }
 }
 }
 """)
 def get_sessions(self, limit: int = 10) -> dict:
 return self._request("""
 query SessionList($limit: Int) {
 user {
 sessionList(limit: $limit) {
 id sessionName ip country active updatedAt
 }
 }
 }
 """, variables={"limit": limit})
 def send_tip(self, user_id: str, amount: float, currency: str,
 tfa: Optional[str] = None) -> dict:
 variables = {
 "userId": user_id,
 "amount": amount,
 "currency": currency,
 "isPublic": True,
 "chatId": "c65b4f32-0001-4e1d-9cd6-e4b3538b43ae",
 }
 if tfa:
 variables["tfaToken"] = tfa
 return self._request("""
 mutation SendTip($userId: String!, $amount: Float!, $currency: CurrencyEnum!,
 $isPublic: Boolean, $chatId: String!, $tfaToken: String) {
 sendTip(userId: $userId, amount: $amount, currency: $currency,
 isPublic: $isPublic, chatId: $chatId, tfaToken: $tfaToken) {
 id amount currency
 user { id name }
 }
 }
 """, variables=variables, operation="SendTip")
 def withdraw(self, currency: str, address: str, amount: float,
 email_code: Optional[str] = None, tfa: Optional[str] = None) -> dict:
 variables = {"currency": currency, "address": address, "amount": amount}
 if email_code:
 variables["emailCode"] = email_code
 if tfa:
 variables["tfaToken"] = tfa
 return self._request("""
 mutation CreateWithdrawal($currency: CryptoCurrencyEnum!, $address: String!,
 $amount: Float!, $emailCode: String, $tfaToken: String) {
 createWithdrawal(currency: $currency, address: $address, amount: $amount,
 emailCode: $emailCode, tfaToken: $tfaToken) { id }
 }
 """, variables=variables, operation="CreateWithdrawal")
# --- Usage ---
client = StakeClient("YOUR_API_KEY")
result = client.get_balances()
for b in result["data"]["user"]["balances"]:
 avail = b["available"]
 print(f"{avail['currency'].upper()}: {avail['amount']}")

Python — Live bet monitor

import time
import requests
API_KEY = "your_api_key"
ENDPOINT = "https://stake.com/_api/graphql"
HEADERS = {"content-type": "application/json", "x-access-token": API_KEY}
QUERY = """
query { user { sportBetList(limit: 5, offset: 0) {
 id
 bet { ... on SportBet {
 amount currency payout status
 outcomes { fixture { name } odds status }
 }}
}}}
"""
seen = set()
print("Monitoring bets... (Ctrl+C to stop)")
while True:
 try:
 r = requests.post(ENDPOINT, headers=HEADERS, json={"query": QUERY})
 bets = r.json()["data"]["user"]["sportBetList"]
 for item in bets:
 if item["id"] not in seen:
 seen.add(item["id"])
 b = item["bet"]
 profit = b["payout"] - b["amount"]
 sign = "+" if profit >= 0 else ""
 match = b["outcomes"][0]["fixture"]["name"] if b["outcomes"] else "?"
 print(f"[{b['currency'].upper()}] {match}: {b['amount']:.6f} → {sign}{profit:.6f}")
 except Exception as e:
 print(f"Error: {e}")
 time.sleep(5)

Supported Currencies

Error Handling

response = requests.post(ENDPOINT, headers=headers, json={"query": query})
data = response.json()
if "errors" in data:
 for error in data["errors"]:
 msg = error["message"]
 # Common errors:
 # "Not authenticated" — invalid/missing API key
 # "Too many requests" — slow down, you're rate limited
 # "Forbidden" — action not allowed for your account
 # "Invalid otp" — wrong 2FA or email code
 print(f"API Error: {msg}")
else:
 print(data["data"])

Bot Features

Account Management

ROI Analytics

Finance

Market Intelligence (no token required)

Alerts

Languages

Why Use the Bot?

Русский — Обзор

POST https://stake.com/_api/graphql

Аутентификация

Получение API токена

Заголовки запроса

POST https://stake.com/_api/graphql
Content-Type: application/json
x-access-token: ВАШ_ТОКЕН

Быстрый старт

import requests
API_KEY = "ваш_api_токен"
ENDPOINT = "https://stake.com/_api/graphql"
headers = {
 "content-type": "application/json",
 "x-access-token": API_KEY,
}
query = """
query UserBalances {
 user {
 balances {
 available { amount currency }
 }
 }
}
"""
r = requests.post(ENDPOINT, headers=headers, json={"query": query})
for b in r.json()["data"]["user"]["balances"]:
 print(f"{b['available']['currency'].upper()}: {b['available']['amount']}")

Методы API

Запросы (чтение)

Мутации (запись)

Telegram бот

Дисклеймер / Disclaimer

If this helped you, star the repo — it helps others find it

Telegram