Skip to main contentSkip to FAQSkip to contact
API Reference

REST and WebSocket APIs for taker submissions, solver integrations, compliance checks, and settlement tracking.

Base URL: https://api.tetrafi.io/v1

Authentication via API key in Authorization: Bearer header. WebSocket uses token-based auth on connection.

Quick Start - Submit an RFQ

cURL
1curl -X POST https://api.tetrafi.io/v1/rfq \
2  -H "Authorization: Bearer YOUR_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "pair": "USDC/USDT",
6    "side": "buy",
7    "amount": "1000000",
8    "chain": "optimism"
9  }'
9 linesbash
POST

Submit RFQ

/api/v1/rfq

Broadcast a Request for Quote to competing solvers. Returns quote responses within the auction window.

RFQTaker
GET

Get Quotes

/api/v1/quotes/{rfqId}

Retrieve all solver responses for a given RFQ. Includes pricing, fill rate, and latency metrics.

QuotesTaker
POST

Accept Quote

/api/v1/accept

Accept a solver's quote and initiate the settlement process. Triggers escrow deposit on origin chain.

SettlementTaker
WS

Solver Quote Stream

/ws/v1/solver/stream

WebSocket endpoint for solvers to receive real-time RFQ broadcasts and submit pricing responses.

WebSocketSolver
GET

Compliance Status

/api/v1/compliance/status

Check the compliance status of a participant. Returns KYC/KYB verification state, sanctions screening result, and Travel Rule readiness.

ComplianceStatus
GET

Settlement Details

/api/v1/settlements/{id}

Retrieve settlement details including escrow status, cross-chain proof verification, and final settlement hash.

SettlementAudit
GET

Audit Trail

/api/v1/audit/{tradeId}

Retrieve the complete WORM evidence ledger entry for a trade - compliance checks, quotes, execution, and settlement proof.

AuditWORM
POST

Register as Solver

/api/v1/solver/register

Submit solver registration with KYB details and pricing engine configuration. Triggers compliance verification flow.

SolverOnboarding

Interactive API Explorer

Full endpoint schemas, request/response examples, and multi-language code generation.

Sandbox Mode - The TetraFi API is in development. Schemas and examples below represent the target API design. The try-it console will be enabled when the sandbox launches.