Integrate Pinbar AI in One Afternoon
Give your traders institutional-grade analytics and AI-powered journaling. Works with any broker, any platform, any asset class.
Choose Your Integration Method
Three ways to connect. Pick the one that fits your setup. All methods deliver the same powerful analytics.
Pre-Built Connectors
Install a ready-made connector for MetaTrader, cTrader, DXTrade, Binance, Bybit, OKX, Kraken, or Interactive Brokers. One install covers all traders on that platform. Zero code required.
REST API
Send trade data to our universal API endpoint. Works with any trading platform, any broker, any system. Your developer writes a small script that pushes trades automatically.
JavaScript SDK
Embed Pinbar AI analytics directly inside your existing web platform. Drop a script tag into your site and your traders see analytics without leaving your app.
How Integration Works
Four steps from signup to live. Most companies finish in a single afternoon.
Sign Up for Enterprise
Create your enterprise account via pinbar.ai/enterprise. Select your company type (Broker, Prop Firm, Trading Desk, or individual). You'll receive your tenant ID and API credentials instantly.
Connect Your Trading Platform
If your traders use MetaTrader, cTrader, DXTrade, Binance, Bybit, OKX, Kraken, or Interactive Brokers — install our pre-built connector. It takes 15 minutes and covers all your traders at once. If you use a different platform, use our REST API to push trades (see code examples below).
Invite Your Traders
Send invitations via email or share a signup link. Each trader creates their account within your organization's tenant. They see your company's analytics dashboard powered by Pinbar AI.
Trades Flow Automatically
Once connected, every trade from every trader on every platform syncs to Pinbar AI automatically. Your admin dashboard shows real-time analytics across all traders, all asset classes, and all Brokers. No manual uploads. Ever.
Pre-Built Connectors
Install one connector per platform. Covers every trader on that platform automatically.
MetaTrader 4 / 5
Covers 10,000+ forex and CFD Brokers worldwide
- Download the Pinbar AI Expert Advisor (EA) file
- Copy the EA file to your MetaTrader Experts folder
- Open MetaTrader, attach the EA to any chart
- Enter your Pinbar AI API key when prompted
- The EA auto-detects all accounts on the server and syncs every trade
Setup time: 10 minutes
cTrader
Growing platform used by many Prop Firms
- Download the Pinbar AI cBot from cTrader Automate
- Install the cBot in your cTrader instance
- Enter your Pinbar AI API key
- The cBot syncs all accounts and trades automatically
Setup time: 10 minutes
DXTrade
Prop firm and retail broker trading platform
- Your DXTrade admin configures a webhook URL: https://api.pinbar.ai/mt-ingest
- Set the Authorization header to Bearer YOUR_API_KEY
- Trades push to Pinbar AI automatically as they execute
- No trader-side setup needed — broker configures it once
Unlike pull-based connectors, DXTrade uses push-based server-side trade ingestion via the mt-ingest endpoint.
Setup time: 15 minutes
Binance / Bybit
Major crypto exchanges — spot, futures, and margin
- Generate a read-only API key from your exchange (no withdrawal permissions)
- Paste the API key and secret into Pinbar AI dashboard
- Select which sub-accounts to sync (or sync all)
- All past and future trades sync automatically
Setup time: 5 minutes
OKX
Spot, swaps, and futures — HMAC SHA256 + passphrase
- Generate a read-only API key, secret, and passphrase from OKX
- Paste all three credentials into Pinbar AI dashboard
- Trades sync across SPOT, SWAP, and FUTURES instrument types
- Paginated history with automatic PnL calculation
Setup time: 5 minutes
Kraken
Spot and margin trading — HMAC SHA512 auth
- Generate a read-only API key and private key from Kraken
- Paste credentials into Pinbar AI dashboard
- All trade history syncs with offset-based pagination
- Automatic FIFO PnL mapping across trading pairs
Setup time: 5 minutes
Interactive Brokers
Stocks, options, futures, forex — global markets
- Authorize Pinbar AI via IB OAuth (Client Portal API)
- Select which accounts to sync
- All executions, positions, and P&L sync automatically
- Supports individual and institutional advisor accounts
Setup time: 10 minutes
Zerodha / Angel One / Dhan
India's largest brokers — equities, F&O, commodities
- Already built into Pinbar AI — no connector needed
- Trader logs into their broker via OAuth inside Pinbar AI
- All trades, positions, and holdings sync automatically
- Supports equities, futures, options, and commodities
Setup time: 2 minutes (already live)
Any Other Platform
Use our universal REST API — works with anything
- Get your API key from the Pinbar AI enterprise dashboard
- Your developer writes a small script (see code examples below)
- The script pushes trades to our API automatically
- Or request our free setup service — we build it for you
Setup time: 1-2 hours (or free setup)
REST API — Universal Integration
Works with any platform, any broker, any programming language. Send a POST request with trade data — that's it.
https://api.pinbar.ai/v1/v1-tradesAuthentication
Include your API key in the request header. You can find your API key in the Enterprise Dashboard under Settings.
Authorization: Bearer YOUR_API_KEY
Content-Type: application/jsonSend Trades — Code Examples
The trades array supports up to 100 trades per request. There is no separate bulk endpoint — simply include multiple trade objects in the array.
import requests
API_KEY = "your_api_key_here"
trades = [{
"external_id": "trade-001",
"account_id": "trader_001",
"symbol": "EURUSD",
"side": "buy",
"quantity": 1.0,
"entry_price": 1.0842,
"exit_price": 1.0891,
"entry_time": "2026-04-08T09:30:00Z",
"exit_time": "2026-04-08T14:15:00Z",
"profit_loss": 49.00,
"commission": 7.00,
"metadata": {"asset_class": "forex", "platform": "MetaTrader 5"}
}]
response = requests.post(
"https://api.pinbar.ai/v1/v1-trades",
json={"trades": trades},
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json"
}
)
print(response.json())
# {"ok": true, "inserted": 1, "updated": 0, "errors": []}Response Format
Success (200)
{
"ok": true,
"inserted": 1,
"updated": 0,
"errors": []
}Error (4xx/5xx)
{
"ok": false,
"error": {
"code": "validation_failed",
"message": "entry_price must be a positive number"
}
}Response Codes
| Code | Meaning | Action |
|---|---|---|
| 200 | Trades accepted | Success — check inserted/updated counts |
| 400 | Invalid format | Check required fields and types |
| 401 | Invalid API key | Verify key in dashboard |
| 413 | Payload too large | Max 1MB or 100 trades per request |
| 429 | Rate limit hit | Wait and retry or upgrade plan |
| 500 | Server error | Retry with exponential backoff |
Rate Limits
Starter
60 req/min
Professional
300 req/min
Enterprise
1,000 req/min
Custom
Contact us
Check your remaining quota via the X-RateLimit-Remaining response header. Contact info@pinbar.ai for custom limits.
Outbound Webhooks
Receive real-time notifications when important events happen. All webhooks are signed with HMAC-SHA256 for verification.
Available Events
trade.analyzedWhen AI finishes analyzing a traderisk.alertWhen a trader breaches a drawdown or risk thresholdevaluation.status_changedWhen a trader passes or fails an evaluation (Prop Firms)daily.summaryEnd-of-day aggregate performance reportWebhook Setup
Configure webhook endpoints in your Enterprise Dashboard under Settings → Integrations → Webhooks.
Verification
Every webhook includes an X-Pinbar-Signature header. Verify it by computing HMAC-SHA256 of the request body using your webhook signing secret.
Webhook secret rotation
Pinbar AI rotates outbound webhook signing secrets on a rolling schedule. When a rotation begins for one of your active endpoints, your tenant receives a fresh signing secret and a 14-day overlap window in which both the previous and the new secret are accepted. The HMAC-SHA256 scheme itself does not change — only the secret value rotates.
Rotation steps
- Open Integrations → Webhooks in your workspace and copy the new signing secret.
- Add it as the next secret in your receiver, keeping the previous one active.
- Verify both secrets validate live deliveries (replay a test event).
- Remove the previous secret on or after the cutoff date shown in the in-app banner.
Dual-verify reference (overlap window)
import crypto from "node:crypto";
function verify(secret, body, sigHeader) {
const parts = Object.fromEntries(
sigHeader.split(",").map(p => {
const i = p.indexOf("=");
return [p.slice(0, i).trim(), p.slice(i + 1).trim()];
})
);
const expected = crypto
.createHmac("sha256", secret)
.update(`${parts.t}.${parts.n}.${body}`)
.digest("hex");
return crypto.timingSafeEqual(
Buffer.from(expected, "hex"),
Buffer.from(parts.v1, "hex")
);
}
export function verifyWithRotation({ currentSecret, previousSecret, cutoff, body, sigHeader }) {
if (verify(currentSecret, body, sigHeader)) return { ok: true, used: "current" };
if (previousSecret && cutoff && Date.now() < new Date(cutoff).getTime()) {
if (verify(previousSecret, body, sigHeader)) return { ok: true, used: "previous" };
}
return { ok: false };
}Nothing in this section constitutes financial, investment, or trading advice. Questions? info@pinbar.ai.
JavaScript SDK — Embedded Analytics
Embed Pinbar AI analytics directly inside your existing web platform.
<!-- Add to your HTML -->
<script src="https://cdn.pinbar.ai/sdk/v1/pinbar.min.js"></script>
<div id="pinbar-analytics"></div>
<script>
PinbarAI.init({
tenantId: 'YOUR_TENANT_ID',
apiKey: 'YOUR_API_KEY',
container: '#pinbar-analytics',
theme: 'dark', // or 'light'
features: ['analytics', 'journal', 'ai-insights'],
locale: 'en'
});
</script>Full SDK documentation and component library available upon request. Contact info@pinbar.ai for SDK access.
Trade Data Format
Every trade you send follows this simple structure. Only 7 fields are required — the rest are optional but help Pinbar AI generate richer analytics.
| Field | Type | Required | Description |
|---|---|---|---|
| external_id | string | REQUIRED | Your unique trade ID — used for deduplication |
| symbol | string | REQUIRED | Instrument symbol (e.g. EURUSD, BTCUSD, AAPL) |
| side | string | REQUIRED | "buy" or "sell" |
| entry_price | number | REQUIRED | Price at which the trade was opened |
| quantity | number | REQUIRED | Lot size / quantity |
| entry_time | ISO 8601 | REQUIRED | Entry timestamp (UTC) |
| account_id | string | REQUIRED | Trader account identifier — maps to a trader in your org |
| exit_price | number | optional | Exit price (omit for open positions) |
| exit_time | ISO 8601 | optional | Exit timestamp |
| profit_loss | number | optional | Realized P&L |
| commission | number | optional | Commission / fees |
| metadata | JSON | optional | Arbitrary metadata (asset_class, platform, tags, notes, stop_loss, take_profit) |
Can't Do It Yourself? We'll Set It Up For You.
No developer? No problem. Our team will configure the entire integration at no extra cost. Here's how it works:
Book a Setup Call
Schedule a 30-minute call with our integration team. Tell us which trading platforms your traders use and how many traders you have.
We Configure Everything
On the call, we walk you through installing the connector — or we do it remotely via screen share. For custom platforms, we write the integration script for you.
Test & Verify
We run a live test to make sure trades are flowing correctly from every platform and every broker your traders use.
Go Live
Once verified, we activate your account. Your traders are automatically covered. We stay available for 30 days of priority support after launch.
Frequently Asked Questions
Ready to Give Your Traders an Edge?
Join the growing list of Brokers, Prop Firms, and Trading Desks powered by Pinbar AI intelligence.
info@pinbar.ai · pinbar.ai/enterprise
Pinbar AI is a journaling/analytics tool and does not provide financial or investment advice. All insights are descriptions of your own logged trades — past performance does not guarantee future results.