SDK & Partner Integration

API documentation and partner onboarding for the FTH USDF private network. All partners hold TCB accounts at Texas Capital Bank.

2
Active Partners
2
Onboarding
7
API Endpoints
6
Networks

Partner Network

US
Tether (USDT)
Stablecoin Issuer · TCB account for USDF→USDT conversion
LIVE
EthereumTronBSCMint/Burn APIConversion BridgeWire Settlement
US
Circle (USDC)
Stablecoin Issuer · TCB account for USDF→USDC conversion
LIVE
EthereumSolanaPolygonMint/Burn APIConversion BridgeWire Settlement
XA
Souk Gold (XAUT)
Commodity Tokenizer · Gold-backed asset tokenization and USDF settlement
⏳ ONBOARDING
EthereumAsset Registry APIUSDF Settlement
BM
BMW Financial (BMW)
Auto Finance · Vehicle asset tokenization and USDF payment rails
⏳ ONBOARDING
PolygonAsset Registry APIPayment APIUSDF Settlement

API Reference

POST
/api/v1/members
Create new member account
API Key + HMAC
GET
/api/v1/members/:id/balance
Query member USDF & USD balances
API Key
POST
/api/v1/mint
Mint USDF to member wallet (USD must be settled first)
API Key + Webhook
POST
/api/v1/burn
Burn member USDF and initiate USD wire return
API Key + HMAC
POST
/api/v1/convert
Convert member USDF to USDT/USDC via partner TCB
API Key + Webhook
GET
/api/v1/transactions/:id
Check transaction status and compliance result
API Key
POST
/api/v1/webhooks/register
Register webhook endpoint for settlement events
API Key

Quick Start

// FTH USDF SDK — Partner Integration
import { FthClient } from '@fth/usdf-sdk';

const fth = new FthClient({
  apiKey: process.env.FTH_API_KEY,
  secret: process.env.FTH_HMAC_SECRET,
  environment: 'production', // or 'sandbox'
});

// Mint USDF for a member after USD wire received
const mint = await fth.mint({
  memberId: 'mbr_abc123',
  amount: 50000.00,        // USD amount
  chain: 'XRPL',           // XRPL mainnet
  reference: 'WIRE-2026-0042',
});
// → { txId: 'MNT-...', status: 'settled', hash: 'ABC...' }

// Convert member USDF to USDT via Tether TCB
const convert = await fth.convert({
  memberId: 'mbr_abc123',
  amount: 10000.00,
  targetAsset: 'USDT',
  network: 'Ethereum',
  destAddress: '0x1234...abcd',
});
// → { txId: 'CVT-...', status: 'pending_wire' }

Integration Overview

1
Partner Onboarding
KYC/AML, TCB account setup, API key provisioning
2
SDK Integration
Install @fth/usdf-sdk, configure API keys, set webhooks
3
Sandbox Testing
Test mint, burn, convert flows with sandbox API endpoint
4
Go Live
Compliance review, production keys, wire settlement activated

Security Model

HMAC-SHA256 request signing
IP allowlist for production
Mutual TLS (mTLS) optional
Webhook signature verification
SOC 2 Type II audit trail

Support

Sandbox: sandbox.api.fthusd.com
Production: api.fthusd.com
Docs: docs.fthusd.com