# Bity — how to use (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).

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_bity?ms=1781044800000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `bity_executed_orders`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/bity`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/bity/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/bity/executed/orders` — Histórico de ordens já executadas da conta. `market` opcional pra filtrar por par.
  - body: { market?: string, account?: string }
- `POST https://api.mcp.ai/api/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.
  - body: { account?: string }
- `POST https://api.mcp.ai/api/bity/list/accounts` — Lista as contas Bity conectadas a este install — id, label.
  - body: { account?: string }
- `POST https://api.mcp.ai/api/bity/open/orders` — Lista as ordens em aberto (pendentes) da conta. `market` opcional pra filtrar por par.
  - body: { market?: string, account?: string }
- `POST https://api.mcp.ai/api/bity/order/status` — Status de uma ordem específica pelo seu id.
  - body: { order_id: string, account?: string, order_ids?: string[] }
- `POST https://api.mcp.ai/api/bity/orderbook` — Livro de ofertas (bids/asks) de um par. Público.
  - body: { market?: string, account?: string }
- `POST https://api.mcp.ai/api/bity/ticker` — Ticker 24h de um par (último preço, melhor compra/venda, volume). Público, não exige saldo.
  - body: { market?: string, account?: string }
- `POST https://api.mcp.ai/api/bity/trades` — Negociações recentes (trades públicos) de um par. Público.
  - body: { market?: string, account?: string }

## Example prompts
- "Qual meu saldo em BTC e BRL no Bity?"
- "Qual o preço atual do BTC-BRL no Bity?"
- "Liste minhas ordens em aberto"

## More
- Page: https://mcp.ai/bity
- Agent spec (llms.txt): https://mcp.ai/bity/llms.txt
- Postman collection: https://mcp.ai/bity/postman.json