Documentação › Conta

Coin API

A Coin API deixa você ler os dados de Tibia Coins da sua própria conta por uma API HTTP externa e montar os seus scripts. Dá para fazer, por exemplo, um "banco" de Tibia Coins: acompanhar quem enviou e quem recebeu coins e saber o saldo atual.

Quem registra os dados é o próprio bot, dentro do cliente. Ele guarda o que o cliente já recebe e envia para o ledger privado da sua conta. É só observação: o bot nunca envia coins — ele apenas registra a transferência que você mesmo faz no cliente.

Como funciona#

  1. Com o adicional ativo, o bot registra os dados de coins que o cliente recebe e sobe para o ledger da sua conta.
  2. Você faz login na API com o mesmo usuário e senha do launcher e do fórum/comunidade e recebe um token.
  3. Com o token, você lê o seu saldo, o seu histórico e as suas transferências, e monta o script que quiser.

A URL base é https://api.drenoxbot.com. Ela também aparece no painel da API, dentro do seu Painel.

Como assinar#

O adicional não é um plano separado: ele entra junto com o Pro ou o Pro Max.

  • Plano novo: no checkout, marque Coin API no passo Adicional. Ela vale pelo mesmo período do plano (mensal, semestral ou anual), no mesmo pagamento.
  • Já tem plano ativo: no seu Painel, o card Coin API ativa o adicional por 30 dias com PIX, ou como assinatura mensal no cartão, que renova sozinha. Cancele quando quiser em Gerenciar assinatura, no mesmo Painel.

Painel da API#

Com o adicional ativo, o seu Painel ganha o painel da API, com tudo o que você precisa para usar a API:

  • a validade do adicional e o botão para renovar;
  • o saldo (total, transferível e em leilões) e quando foi atualizado;
  • a URL base, os endpoints e o escopo do token;
  • exemplos prontos em curl, Python e JavaScript, já com o seu usuário, com botão de copiar;
  • as últimas transações e as transferências que você enviou.

POST /coins/login#

Faça login para receber um token. O corpo é JSON:

json
{ "user": "<sua conta>", "password": "<sua senha>" }

São as mesmas credenciais que entram no launcher e na comunidade/fórum. A resposta:

json
{ "token": "...", "exp": 1730000000 }

O token vale 7 dias (exp é o vencimento, em segundos Unix).

Erros

  • 401 — credenciais inválidas.
  • 403 — coin API requires an active Pro plan and the Coin API add-on.

GET /coins#

Envie o token no cabeçalho Authorization: Bearer <token>. A resposta:

json
{
  "balance": { "total": 0, "transferable": 0, "auction": 0, "at": 1730000000 },
  "entries": [
    {
      "id": 1,
      "ts": 1730000000,
      "delta": 25,
      "kind": "received",
      "counterparty": "<outro personagem>",
      "desc": "...",
      "hasDetails": true
    }
  ],
  "sends": [
    { "to": "<personagem>", "amount": 25, "at": 1730000000 }
  ]
}
  • balance — os totais de coins atuais: total, transferable (transferíveis) e auction (de leilão), com at (quando foi medido).
  • entries — o histórico de transações. delta é a variação de coins com sinal (+ recebido / - gasto); kind é received, sent ou store; counterparty é o outro personagem nas transferências; hasDetails indica se há mais detalhes.
  • sends — as transferências de saída que você fez: para quem (to), quanto (amount) e quando (at).

Exemplo com curl#

Primeiro faça login para pegar o token:

bash
curl -s -X POST https://api.drenoxbot.com/coins/login \
  -H "Content-Type: application/json" \
  -d '{"user":"sua-conta","password":"sua-senha"}'

Depois, com o token da resposta, leia os seus coins:

bash
curl -s https://api.drenoxbot.com/coins \
  -H "Authorization: Bearer SEU_TOKEN"

Exemplo com Python#

python
import requests

API = "https://api.drenoxbot.com"
token = requests.post(f"{API}/coins/login", json={"user": "sua-conta", "password": "sua-senha"}).json()["token"]
data = requests.get(f"{API}/coins", headers={"Authorization": f"Bearer {token}"}).json()

print(data["balance"]["total"])
for e in data["entries"][:10]:
    print(e["kind"], e["delta"], e.get("counterparty") or e.get("desc"))