Docs

Get started

Connecting Claude

BT Gateway speaks the Model Context Protocol (MCP) at /mcp — the open standard Claude and other modern AI tools use to talk to apps. To add the connector:

1. In Claude, open Settings → Connectors → Add custom connector.
2. Paste https://bt-gateway.bogdanripa.com/mcp (or your own deployment's URL).
3. Claude opens a sign-in window. Sign in with Google, pick demo or live, optionally inherit filters from an existing API key, and choose read-only or read + place orders.
4. Revoke the connector any time from Settings — it cuts off Claude's access immediately.

What Claude can do today: see your cash balance and holdings, look at open and recent orders, look up instruments and markets, preview an order without placing it, and (if you grant write access) place orders.

REST API

For scripts, iOS Shortcuts, or your own app, authenticate every call with Authorization: Bearer bvb_<mode>_<token>. Generate keys under Settings → Access after you've set up at least one account. The mode is baked into the key prefix: a bvb_demo_… key can only touch the demo account; a bvb_live_… key can only touch the live one.

Common endpoints

• GET /api/v1/cash — cash balances
• GET /api/v1/holdings — open positions and P&L
• GET /api/v1/orders — orders, filterable by status / side / symbol / date
• POST /api/v1/orders/preview — try an order without sending it
• POST /api/v1/orders — place an order (read+write keys only)
• GET /api/v1/markets and GET /api/v1/instruments/:symbol — reference data

Each key can carry per-axis allow/deny lists (markets, currencies, symbols), so a sandboxed key sees a sandboxed view.

Security model

• Your BT credentials and Telegram bot token are encrypted at rest with Google Cloud KMS.
• API keys are stored as one-way hashes — the raw key is shown exactly once at creation.
• Every order, sign-in, and credential change shows up in your own audit log.
• Live and demo are fully isolated — separate credentials, separate keys, separate connections. A demo key cannot touch live money, by construction.
• Connecting an AI assistant requires you to be signed in to the dashboard with Google — nothing is added without your explicit consent.

FAQ

What is BT Gateway?

A small service that lets Claude and other AI assistants talk to your Banca Transilvania trading account, and also offers a REST API for scripts.

Do I need a real BT Trade account?

No. You can create a free demo trading account on bt-trade.ro and connect that. The demo behaves like the real account but uses play money.

How does BT Gateway sign in to BT?

You enter your BT username and password into the dashboard once; they are encrypted at rest. The first sign-in needs a one-time code (SMS for live, email for demo) that a small automation on your phone forwards over. After that, the connection stays alive automatically.

Can I limit what Claude can do?

Yes. Each connection can be read-only or read + place orders, and you can restrict it to specific markets, currencies, or symbols.

Is BT Gateway affiliated with Banca Transilvania?

No. It's an independent tool that acts on your behalf using credentials you provide.