FUTURE BDET BANK

API DOCS v6.0.0 · 147 ENDPOINTS

LIVE

PORTAL

📚 API DOCUMENTATION v6

147 Endpoints · 5 SDKs · WebSocket · OpenAPI 3.1 · 2,668 Tokens

Quick Start Changelog

VERSIONv6.0.0

ENDPOINTS147 active

SDKs5 langs

OpenAPI3.1

WebSocketwss://

Latency<40ms

Sandbox✓ Free

Tokens2,668

Pairs22 active

Volume 24h$847.5M

Uptime99.97%

AuthAPI Key + HMAC

VERSIONv6.0.0

ENDPOINTS147 active

SDKs5 langs

OpenAPI3.1

WebSocketwss://

Latency<40ms

Sandbox✓ Free

Tokens2,668

Pairs22 active

Volume 24h$847.5M

Uptime99.97%

AuthAPI Key + HMAC

Quick Start

De cero a primera transacción en 5 minutos. Sandbox gratis sin tarjeta de crédito.

Sandbox URL: https://sandbox.futurebdetbank.com · synthetic data + test tokens. Idéntica API surface a producción.

1. Crear cuenta sandbox

curl -X POST https://sandbox.futurebdetbank.com/api/v1/auth/register \ -H "Content-Type: application/json" \ -d '{"email":"[email protected]","password":"test123!"}' # Response: { "api_key": "bdet_test_abc123def456...", "api_secret": "sk_test_xyz789...", "user_id": 42 }

2. Tu primera llamada

curl https://sandbox.futurebdetbank.com/api/v1/pairs \ -H "X-API-Key: bdet_test_abc123def456..." # Lista los 22 pairs activos con precios live

3. WebSocket en tiempo real

const ws = new WebSocket("wss://exchange.futurebdetbank.com/ws"); ws.onopen = () => ws.send(JSON.stringify({ channel: "trades:WMP/WUSD", auth: "bdet_test_abc123..." })); ws.onmessage = (e) => console.log(JSON.parse(e.data)); // Stream live trades sub-100ms

Authentication

BDET API soporta múltiples métodos de autenticación. HMAC-SHA256 + API Key es el método recomendado para production.

API Key + HMAC Signature (recomendado)

Cada request firmas con HMAC-SHA256 del payload usando tu API secret. Protege contra MITM y replay attacks.

// JavaScript import crypto from 'crypto'; function sign(payload, secret) { return crypto.createHmac('sha256', secret).update(payload).digest('hex'); } const body = JSON.stringify({pair: "WMP/WUSD", side: "buy", amount: 100}); const ts = Date.now(); const sig = sign(`${ts}${body}`, API_SECRET); fetch("https://exchange.futurebdetbank.com/api/v1/orders", { method: "POST", headers: { "X-API-Key": API_KEY, "X-Timestamp": ts, "X-Signature": sig, "Content-Type": "application/json" }, body });

JWT Bearer (web sessions)

curl -H "Authorization: Bearer eyJhbGc..." ...

OAuth2 (third-party apps)

Flow: Authorization Code con PKCE. Scopes granulares: read, trade, withdraw, settle, admin.

Hardware Key (executive only)

Ledger Enterprise + biometric. Required para treasury, governance overrides, emergency lockdown.

SDKs

SDKs oficiales en 5 lenguajes. Type-safe, retry-aware, auth-handled.

JavaScript / TypeScript

// Install npm install @bdet/sdk // Use import { BdetClient } from '@bdet/sdk'; const client = new BdetClient({ apiKey: process.env.BDET_KEY }); const pairs = await client.exchange.pairs.list(); const order = await client.exchange.orders.create({ pair: 'WMP/WUSD', side: 'buy', type: 'market', amount: 100 });

Python

pip install bdet-sdk import bdet client = bdet.Client(api_key="$BDET_KEY") pairs = client.exchange.pairs.list() order = client.exchange.orders.create( pair="WMP/WUSD", side="buy", type="market", amount=100 ) # Async async with bdet.AsyncClient(api_key="$BDET_KEY") as c: pairs = await c.exchange.pairs.list()

Go

go get bdet.io/sdk import "bdet.io/sdk" client := bdet.NewClient(os.Getenv("BDET_KEY")) pairs, err := client.Exchange.Pairs.List(ctx) order, err := client.Exchange.Orders.Create(ctx, &bdet.OrderRequest{ Pair: "WMP/WUSD", Side: "buy", Type: "market", Amount: 100, })

Rust

cargo add bdet-sdk use bdet_sdk::Client; let client = Client::new("$BDET_KEY"); let pairs = client.exchange().pairs().list().await?; let order = client.exchange().orders().create(OrderRequest { pair: "WMP/WUSD".into(), side: Side::Buy, ..Default::default() }).await?;

PHP

composer require inkg/bdet-php use Bdet\Client; $client = new Client(['api_key' => getenv('BDET_KEY')]); $pairs = $client->exchange->pairs->list();

Core APIs

Auth API · auth.futurebdetbank.com

POST /api/v1/auth/register PUBLIC

Crear nuevo usuario. Returns api_key + secret.

{ "email": "[email protected]", "password": "min8chars", "referral_code": "TAKODA-7X9K" // optional }

POST /api/v1/auth/login PUBLIC

{ "email": "...", "password": "..." }

POST /api/v1/auth/refresh PUBLIC

Renew JWT con refresh token.

{ "refresh_token": "..." }

POST /api/v1/auth/2fa/enable JWT

Enable TOTP 2FA. Returns QR code URL + backup codes.

GET /api/v1/auth/keys JWT

List API keys del user.

POST /api/v1/auth/keys JWT

Generate new API key con permissions específicos.

{ "label": "production-bot", "permissions": ["read", "trade", "settle"], "ip_whitelist": ["1.2.3.4"] }

Exchange API · exchange.futurebdetbank.com

GET /api/v1/pairs PUBLIC

Lista de pairs activos (22). Soporta filtros.

GET /api/v1/tokens PUBLIC

Lista de tokens (2,668 con tribal incluido).

GET /api/v1/orderbook/:pair PUBLIC

Order book live para pair. Default depth=20.

GET /api/v1/trades/recent PUBLIC

Recent trades (último 100).

GET /api/v1/ticker/:pair PUBLIC

Ticker data (last, 24h, vol, high, low).

POST /api/v1/orders HMAC

Place order. Tipos: market, limit, stop_loss, take_profit, OCO.

{ "pair": "WMP/WUSD", "side": "buy", "type": "limit", "price": "47.10", "amount": "100" }

DELETE /api/v1/orders/:id HMAC

Cancel order.

GET /api/v1/balance HMAC

Account balance + portfolio P&L.

Wallet API · wallet.futurebdetbank.com

GET /api/v1/wallet/balance HMAC

Balance per token (todos los 2,668).

POST /api/v1/wallet/deposit HMAC

Generate deposit address per chain.

{ "chain": "ethereum", "token": "USDT" }

POST /api/v1/wallet/withdraw HMAC+2FA

Withdraw to external address. 2FA required.

{ "chain": "ethereum", "token": "USDT", "amount": "1000", "to": "0xabc...", "totp": "123456" }

GET /api/v1/wallet/history HMAC

Transaction history paginated.

Settlement API · settlement.futurebdetbank.com

POST /api/v1/settlement/initiate HMAC

Start cross-border settlement.

{ "corridor": "americas", "amount": 50000, "currency": "USD", "beneficiary_bic": "TDOMCATTTOR", "beneficiary_iban": "CA...", "iso20022_xml": "<pacs.008>..." }

GET /api/v1/settlement/:id HMAC

Settlement status. Lifecycle: pending → verified → posted → completed.

GET /api/v1/corridors PUBLIC

Active corridors (6: Americas, Europe, Asia, Africa, Crypto, Venezuela).

SBLC API · sblc.futurebdetbank.com

POST /sblc/tokenize ADMIN

Tokenize SBLC on MameyNode L1. Admin auth.

{ "issuer_bank": "BDET Bank", "issuer_bic": "BDETINKGXXX", "beneficiary_name": "...", "face_value": 50000000, "currency": "USD", "sblc_type": "financial", "expiry_date": "2027-05-13" }

GET /sblc/list HMAC

Lista de SBLCs.

GET /sblc/:tokenId HMAC

SBLC details.

POST /sblc/:tokenId/draw HMAC

Draw on SBLC. Activa smart contract.

Compliance API · compliance.futurebdetbank.com

POST /api/v1/compliance/kyc JWT

Submit KYC documents. Multipart upload.

POST /api/v1/compliance/risk-check HMAC

AML/OFAC/PEP screening.

{ "wallet": "0x...", "transaction_amount": 50000, "counterparty": "0x..." }

GET /api/v1/compliance/sanctions/check HMAC

Check name vs 17 sanction lists.

Bridge API · bridge.futurebdetbank.com

GET /api/v1/bridge/chains PUBLIC

List bridges (Ethereum, BSC, Polygon, TRON, Solana, Arbitrum).

POST /api/v1/bridge/lock HMAC

Lock tokens en source chain.

{ "token": "WMP", "amount": "1000", "to_chain": "ethereum", "to_addr": "0x..." }

GET /api/v1/bridge/status/:tx HMAC

Bridge transaction status.

Staking API · staking.futurebdetbank.com

GET /api/v1/staking/pools PUBLIC

4 pools: WMP (12.4%), IGCM (8.7%), BHEMP (15.2%), IGCG (18.6%).

POST /api/v1/staking/stake HMAC

Stake tokens.

{ "pool": "WMP", "amount": "1000" }

POST /api/v1/staking/unstake HMAC

Unstake (subject to lock period).

GET /api/v1/staking/rewards HMAC

Pending + claimed rewards.

Mining API · mining.futurebdetbank.com

GET /api/v1/mining/stats PUBLIC

Network mining stats live.

GET /api/v1/mining/pools PUBLIC

6 pools (Kuna, Dakota, Akwesasne, Ngöbe, México Maya, Borinken).

GET /api/v1/mining/wallet/:addr HMAC

Mining wallet stats: hashrate, rewards, history.

WebSocket Streams

Real-time data via WebSocket. Sub-100ms latency. Unlimited concurrent subscriptions (paid tier).

Available Channels

trades:<PAIR> — every trade en ese pair
orderbook:<PAIR> — orderbook updates
ticker:<PAIR> o ticker:all — price ticks
candles:<PAIR>:<INTERVAL> — 1m, 5m, 15m, 1h, 4h, 1d
account:balance — balance changes (auth required)
account:orders — your order updates (auth required)
mining:hashrate — network hashrate
settlement:status — settlement lifecycle events (auth required)
chain:blocks — MameyNode new blocks (40ms cadence)

Webhooks

Server-to-server event notifications. Retry 3x con backoff. HMAC-SHA256 signature en cada request.

Setup

POST /api/v1/webhooks { "url": "https://your-domain.com/bdet-webhook", "events": ["trade.executed", "settlement.complete", "sblc.received"], "secret": "your_webhook_secret" }

Event Types

trade.executed — order filled
trade.canceled — order canceled
settlement.initiated / settlement.complete / settlement.failed
sblc.received / sblc.tokenized / sblc.drawn
wallet.deposit / wallet.withdraw
kyc.approved / kyc.rejected
balance.changed
staking.reward
governance.proposal_created / governance.proposal_passed

Verify Signature

const sig = req.headers['x-bdet-signature']; const expected = crypto.createHmac('sha256', WEBHOOK_SECRET).update(req.rawBody).digest('hex'); if (sig !== expected) return res.status(401).end(); // Process event const { event, data } = req.body;

Error Codes

BDET API usa códigos HTTP estándar + códigos internos en el body. Responses siempre JSON.

HTTP	Code	Message	Cause / Fix
400	INVALID_PAIR	Pair not found	Use valid pair from /api/v1/pairs
400	INVALID_AMOUNT	Amount below min or above max	Check pair min_order/max_order
400	INSUFFICIENT_BALANCE	Wallet balance < amount	Deposit more funds
401	UNAUTHORIZED	Missing or invalid API key	Check X-API-Key header
401	INVALID_SIGNATURE	HMAC signature mismatch	Re-sign con secret correcto
403	PERMISSION_DENIED	API key sin permission	Generate key con required scope
403	IP_NOT_WHITELISTED	IP no en whitelist	Add IP en /api/v1/auth/keys
403	OFAC_HIT	Sanctions hit detected	Contact [email protected]
403	KYC_REQUIRED	KYC tier insufficient	Complete KYC en /api/v1/compliance/kyc
404	NOT_FOUND	Resource not found	Check resource ID
409	ORDER_NOT_CANCELABLE	Order already filled	Check order status first
429	RATE_LIMIT_EXCEEDED	Too many requests	Backoff: see X-RateLimit-Reset header
500	INTERNAL_ERROR	Server error	Retry con backoff. Si persists, contact support
503	MAINTENANCE	Scheduled maintenance	Status page: status.futurebdetbank.com

Rate Limits

Per-key rate limits. Headers en cada response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Tier	REST (req/s)	WebSocket subs	Burst	Daily quota
Public (unauth)	100	20	200	1M req
Authenticated	1,000	100	2,000	10M req
Partner Gold	5,000	500	10,000	100M req
Partner Platinum	10,000	Unlimited	30,000	Unlimited
Enterprise	Custom	Custom	Custom	Negotiable

Backoff strategy: Si recibís 429, espera X-RateLimit-Reset segundos. Implementa exponential backoff con jitter para retries.

Pagination

Cursor-based pagination. Más eficiente que offset para datasets grandes.

GET /api/v1/trades/history?limit=100&cursor=eyJpZCI6... # Response: { "data": [...], "pagination": { "next_cursor": "eyJpZCI6MTczNDgyMzgyMX0=", "has_more": true, "total": 8472 } }

Changelog

v6.0.02026-05-16

🎉 Major release. 2,668 tokens listed (634 nations × 4 + sovereign + crypto + stables + merchant). Full WebSocket overhaul. New SDKs (Rust, PHP). OpenAPI 3.1. Sub-40ms order latency. Cross-chain bridge expanded to 6 chains. SBLC tokenization ERC-1155.

v5.2.02026-04-22

SBLC API public. 10 new corridors. Hardware key auth for executive endpoints. Quantum-safe ML-DSA/Kyber signatures.

v5.1.02026-04-03

Mining API. 6 sovereign pools live. Mersh node onboarding. Slashing protection v2.

v5.0.02026-03-15

MameyNode chain ID 777777 launch. ArchPoS consensus 12,847 TPS. 103 IGT sectoral tokens minted. WAMPUM stablecoin.

v4.7.02026-02-28

Bridge to TRON + Solana. Atomic swap protocol. Fireblocks MPC integration.

v4.5.02026-02-14

Staking pools launched. Liquidity mining incentives. DAO governance v2.

v4.0.02026-01-22

Compliance API public. KYC tiers + OFAC/UN/EU screening. AAA+ audit cert.

v3.0.02025-12-04

Sovereign banking license activated. Settlement gateway. ISO 20022 pacs.008.

v2.0.02025-11-08

Exchange + Trading APIs. Order book live. WebSocket streams. 22 pairs.

v1.0.02025-10-12

Initial release. Auth + Wallet APIs. 6 sovereign tokens.

Migration Guide v5 → v6

v5 keys remain valid. v6 is backward-compatible. Old endpoints throw deprecation warnings.

Breaking Changes

/api/exchange/* moved to /api/v1/exchange/* (versioned)
Token list now returns 2,668 tokens (was 162). Use ?include_tribal=false para v5 behavior.
WebSocket payload structure: {channel, data} instead of flat {...}
HMAC signature now requires timestamp en cada request (X-Timestamp header)

Deprecated

/api/auth/login → use /api/v1/auth/login
Webhook payload format v1 → use v2 con HMAC signature en header
JWT 15-min expiry deprecated; use 1-hour expiry + refresh tokens

New in v6

2,668 token universe (634 nations × 4 + sovereign + crypto + stables + merchant)
Cross-chain bridges to 6 chains (was 4)
Mining API + Staking API public
SBLC ERC-1155 tokenization on MameyNode
Hardware key auth for executive endpoints
Sub-40ms order latency (was 60ms)
OpenAPI 3.1 spec (was 3.0)
5 SDKs (added Rust + PHP)

FUTURE BDET BANK

SUBDOMAINS

📚 API DOCUMENTATION v6

GET STARTED

SDKs

CORE APIs

WEBSOCKETS

WEBHOOKS

REFERENCE

Quick Start

1. Crear cuenta sandbox

2. Tu primera llamada

3. WebSocket en tiempo real

Authentication

API Key + HMAC Signature (recomendado)

JWT Bearer (web sessions)

OAuth2 (third-party apps)

Hardware Key (executive only)

SDKs

JavaScript / TypeScript

Python

Go

Rust

PHP

Core APIs

Auth API · auth.futurebdetbank.com

Exchange API · exchange.futurebdetbank.com

Wallet API · wallet.futurebdetbank.com

Settlement API · settlement.futurebdetbank.com

SBLC API · sblc.futurebdetbank.com

Compliance API · compliance.futurebdetbank.com

Bridge API · bridge.futurebdetbank.com

Staking API · staking.futurebdetbank.com

Mining API · mining.futurebdetbank.com

WebSocket Streams

Available Channels

Webhooks

Setup

Event Types

Verify Signature

Error Codes

Rate Limits

Pagination

Changelog

Migration Guide v5 → v6

Breaking Changes

Deprecated

New in v6