Coin API · Adicional do Pro e Pro Max

Coin API para GuildBank: o ledger de Tibia Coins da sua guild.

A Coin API do DrenoxBot é um ledger de Tibia Coins somente leitura, por conta. O bot lê as store packets que o cliente do Tibia já recebe — saldo, histórico e as transferências que você faz — e reporta ao DrenoxBot. Com ela, uma guild que mantém um banco de coins vê quem enviou o quê, quando e para qual personagem, com uma trilha de auditoria no lugar de confiar em prints.

Ativar no painel   Ver a documentação da API

Como funciona

Login, token, e o saldo e o ledger por HTTP.

Com o adicional ativo, o bot registra os dados de coins que o cliente já recebe no ledger privado da sua conta. Você lê esse ledger por uma API externa.

01

Faça login na API.

Um POST /coins/login com o seu usuário e senha do DrenoxBot (os mesmos do launcher e da comunidade) devolve um token.

02

Receba o token de 7 dias.

O token vale por 7 dias. Envie-o no cabeçalho Authorization: Bearer nas chamadas seguintes.

03

Leia GET /coins.

A resposta traz o saldo atual — total, transferível e de leilão — e o ledger de quem enviou e recebeu coins.

04

Monte o seu script.

Chame a API de tempos em tempos e compare as transações pelo id: cada id novo é um depósito ainda não contabilizado.

Passo a passo completo, exemplos em curl, Python e JavaScript e a URL base na documentação da Coin API.

GuildBank

Reconcilie os depósitos da guild, sem confiar em prints.

Guilds que mantêm um banco de coins — cada membro envia Tibia Coins a um personagem tesoureiro — podem conferir os depósitos de forma automática. O bot de cada membro registra as transferências de coins, e a guild vê quem enviou o quê, quando e para qual personagem.

Trilha de auditoria da tesouraria

  • Cada membro ativa a Coin API na própria conta e compartilha o token
  • Uma ferramenta da guild chama GET /coins por membro
  • Os saldos e as transferências viram um ledger único de depósitos e saques
  • Transparência: quem depositou quanto, quando e em qual personagem

O limite, com honestidade

  • É contabilidade somente leitura, não há transferência automática
  • As transferências de saída aparecem porque o jogador as fez no cliente
  • Cada membro entra por opção, com a própria conta e o próprio adicional
  • Sem o token do membro, a guild não enxerga o ledger dele
O que a API devolve

O formato do GET /coins.

O saldo em total, transferível e de leilão, mais o ledger de transações com a contraparte, o valor e o tipo (recebido, enviado ou loja). Exemplo ilustrativo:

{
  "balance": { "total": 1250, "transferable": 1100, "auction": 150, "at": 1730000000 },
  "entries": [
    { "id": 42, "ts": 1730000500, "delta":  250, "kind": "received", "counterparty": "Guild Banker", "desc": "transfer" },
    { "id": 41, "ts": 1730000100, "delta": -100, "kind": "sent",     "counterparty": "Treasurer",    "desc": "transfer" },
    { "id": 40, "ts": 1729999000, "delta":  -25, "kind": "store",    "counterparty": "",             "desc": "store purchase" }
  ],
  "sends": [
    { "to": "Guild Banker", "amount": 250, "at": 1730000500 }
  ]
}

balance — os totais de coins, com at indicando quando foram medidos. entries — o histórico: delta é a variação com sinal (+ recebido / - gasto) e kind é received, sent ou store. sends — as transferências de saída que o jogador fez no cliente.

Importante

O que a Coin API não faz.

Ela só observa e reporta. Esse é o limite, e ele é de propósito.

Nunca move coins

  • Não envia, saca, move nem controla coins ou contas
  • Não injeta nem manda nada para o jogo — só lê as packets que o cliente recebe
  • As transferências de saída aparecem porque você as fez no cliente, nunca porque a API as executou
  • Não há pagamento automático

Por conta e consentida

  • O ledger é por conta: você só enxerga os seus próprios coins
  • A guild agrega apenas as contas cujos donos têm o adicional e compartilham o token
  • Sem um plano Pro ou Pro Max ativo e sem o adicional, a API responde 403
Como assinar

Um adicional de R$16,50/mês em cima do Pro ou Pro Max.

A Coin API não é um plano separado. Ela entra junto com um plano Pro ou Pro Max ativo — não funciona no teste grátis.

Pelo painel

Com um plano ativo, o card Coin API no seu Painel liga o adicional, do mesmo jeito que os outros adicionais.

No checkout

Em um plano novo, marque Coin API na caixa de adicional do checkout: vale pelo mesmo período do plano, no mesmo pagamento.

Painel da API

Ativo o adicional, o Painel ganha a URL base, os endpoints, o saldo e exemplos prontos em curl, Python e JavaScript, já com o seu usuário.

Dúvidas

Perguntas frequentes.

A Coin API move ou envia Tibia Coins?

Não. A Coin API é somente leitura: ela observa e reporta. O bot lê as store packets que o cliente já recebe e registra saldo, histórico e as transferências que você mesmo fez no cliente. Ela nunca envia, saca, move nem controla coins ou contas, e não existe pagamento automático.

Como monto um banco de Tibia Coins da guild com ela?

Cada membro ativa a Coin API na própria conta e compartilha o token. Uma ferramenta da guild chama GET /coins por membro e junta os saldos e as transferências em um ledger único, para ver quem depositou quanto, quando e em qual personagem — uma trilha de auditoria no lugar de confiar em prints.

Quanto custa e o que preciso ter?

A Coin API é um adicional de R$16,50 por mês em cima de um plano Pro ou Pro Max ativo — não funciona no teste grátis e não é vendida sozinha. Você ativa no painel ou marca no checkout, do mesmo jeito que os outros adicionais.

Em quais servidores a Coin API funciona?

Ela funciona onde o cliente do DrenoxBot roda: hoje em OTs com o cliente da CipSoft 15.23+ e 15.30 e em OTs com OTClient. O suporte ao RubinOT e ao Tibia Global chega com o plano Pro Max em 2027.

Outra pessoa consegue ler os meus coins?

Não. O ledger é por conta e consentido: você só enxerga os seus próprios coins, e uma guild só agrega as contas cujos donos têm o adicional e compartilham o próprio token. Sem o token, ninguém lê o seu ledger.

Ative a Coin API no painel e monte o banco de coins da sua guild.

Ativar no painel