Bity — REST API skill

Você tem acesso à Bity REST API na MCP.AI.

Banco cripto Bity (Bitybank / Bitypreço), saldo da conta por moeda, dados de mercado (ticker, livro de ofertas, negociações) e histórico de ordens, via API REST oficial (api.bitpreco.com). Somente leitura. Autenticação por signature + api_key (gerados na conta Bity, em Conta, Segurança, Solicitar API).

Base URL

https://api.mcp.ai/api/bity

Todo endpoint é um POST na Base URL + o path abaixo. Os parâmetros vão no corpo JSON.

Autenticação

Inclua em toda request:

Authorization: Bearer sk_live_...
Content-Type: application/json

Gere sua chave em https://app.mcp.ai/settings/api-keys (workspace API key sk_live_…, não expira, revogável). Uma única chave serve pra todos os seus MCPs.

Formato de resposta

{ "ok": true, "tool": "<tool_id>", "result": <payload> }

Exemplo cURL

curl -X POST https://api.mcp.ai/api/bity/executed/orders \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{}'

Reportar problemas

Se um endpoint retornar erro, vazio ou dado inesperado, reporte (não desista calado): POST /api/bity/report com { "message": "...", "context"?: "...", "conversation"?: [...] }. Isso notifica o time da MCP.AI.

Endpoints (8)

#### bity_executed_orders

Histórico de ordens já executadas da conta. market opcional pra filtrar por par. _(POST /api/bity/executed/orders)_

#### bity_get_balance

Saldo da conta: disponível e bloqueado por moeda (ex.: BTC, BTC_locked, BRL, BRL_locked). O saldo total de cada moeda é disponível + bloqueado. _(POST /api/bity/get/balance)_

#### bity_list_accounts

Lista as contas Bity conectadas a este install — id, label. _(POST /api/bity/list/accounts)_

#### bity_open_orders

Lista as ordens em aberto (pendentes) da conta. market opcional pra filtrar por par. _(POST /api/bity/open/orders)_

#### bity_order_status

Status de uma ordem específica pelo seu id. _(POST /api/bity/order/status)_

#### bity_orderbook

Livro de ofertas (bids/asks) de um par. Público. _(POST /api/bity/orderbook)_

#### bity_ticker

Ticker 24h de um par (último preço, melhor compra/venda, volume). Público, não exige saldo. _(POST /api/bity/ticker)_

#### bity_trades

Negociações recentes (trades públicos) de um par. Público. _(POST /api/bity/trades)_

Este MCP também funciona via conexão MCP (Claude / Cursor) em https://api.mcp.ai/p_bity — veja o README. A skill acima é pra consumir a REST API direto (agente próprio / código).