# TetraFi

## Docs

- [Home](https://tetrafi.mintlify.app/home.md): Institutional execution, compliance, and settlement infrastructure for stablecoins and tokenized real-world assets.
- [Why TetraFi](https://tetrafi.mintlify.app/why-tetrafi.md): The mission, and the segment: settlement rails for stablecoins and tokenized real-world assets, at institutional size.
- [How TetraFi Works](https://tetrafi.mintlify.app/how-tetrafi-works.md): What happens between your request and settlement - and which product to build on.
- [TetraFi T+0 Vaults](https://tetrafi.mintlify.app/vaults.md): One primitive that turns delayed settlement into instant settlement - coming soon.
- [How It Works](https://tetrafi.mintlify.app/vaults/how-it-works.md): An exchange, not a loan - the mechanism behind T+0 liquidity.
- [Participants](https://tetrafi.mintlify.app/vaults/participants.md): Curators, depositors, executors, and asset issuers - four roles, one vault.
- [Use Cases](https://tetrafi.mintlify.app/vaults/use-cases.md): Four settlement gaps, one primitive - where T+0 Vaults go to work first.
- [Overview](https://tetrafi.mintlify.app/netting.md): Offset obligations across the network before they move - coming soon.
- [How It Works](https://tetrafi.mintlify.app/netting/how-it-works.md): Clearing cycles, the settlement choice, and where the residual goes.
- [RWA & Stablecoin Issuers](https://tetrafi.mintlify.app/use-cases/rwa-issuers.md): Secondary liquidity and your own mint and redemption rails - on one route, no pools to fund.
- [Consumer Apps & Wallets](https://tetrafi.mintlify.app/use-cases/consumer.md): Swaps that behave: the shown price settles, every time, on every network you serve.
- [Institutional Apps](https://tetrafi.mintlify.app/use-cases/institutional.md): Size without slippage, counterparties you choose, portfolios rebalanced in one settlement.
- [Payment Networks & PSPs](https://tetrafi.mintlify.app/use-cases/payment-networks.md): Stablecoin corridors at settlement size - counterparties, jurisdictions, and the cost layer all under your control.
- [Aggregators](https://tetrafi.mintlify.app/use-cases/aggregators.md): Institutional inventory in your route set - same-chain and across corridors, priced firm before anything moves.
- [Market Makers & Solvers](https://tetrafi.mintlify.app/use-cases/market-makers.md): Professional liquidity, three ways in - quote into the venue, source depth for auctions, or win the liquidation race.
- [Monetize](https://tetrafi.mintlify.app/monetize.md): Turn your integration's flow into revenue, one settled trade at a time.
- [API Overview](https://tetrafi.mintlify.app/build.md): Find the right TetraFi API for what you're building.
- [Coverage](https://tetrafi.mintlify.app/supported-chains.md): The assets, flows, and networks TetraFi's settlement rails reach.
- [Authentication](https://tetrafi.mintlify.app/core-concepts/authentication.md): Credentials for the trading and data surface - what to get, where to send it.
- [Token Approvals](https://tetrafi.mintlify.app/core-concepts/token-approvals.md): Grant the allowances that let settlement pull your input tokens - once, or per trade.
- [Execution Modes](https://tetrafi.mintlify.app/core-concepts/execution-modes.md): Choose between API-submitted and self-broadcast settlement across TetraFi's APIs.
- [Settlement & Smart Contracts](https://tetrafi.mintlify.app/core-concepts/settlement-smart-contracts.md): TetraFi's on-chain architecture - your own immutable router, shared venue modules, and escrow settlement.
- [Monetization](https://tetrafi.mintlify.app/core-concepts/monetization.md): Wire fee revenue into your integration - configuration, disclosure fields, and tracking.
- [Introduction](https://tetrafi.mintlify.app/rfq-api/introduction.md): Firm, escrow-backed quotes from competing solvers and LPs - delivery or refund, never limbo.
- [Quickstart](https://tetrafi.mintlify.app/rfq-api/quickstart.md): From your first firm quote to a settled trade on the RFQ API.
- [Best Practices](https://tetrafi.mintlify.app/rfq-api/guides/best-practices.md): The operating rules that keep your RFQ integration on the full liquidity surface.
- [Order Submission](https://tetrafi.mintlify.app/rfq-api/guides/gasless-execution.md): Have TetraFi land the settlement transaction - your users sign once and never touch gas.
- [Multi-Token Trades](https://tetrafi.mintlify.app/rfq-api/guides/multi-token-trades.md): Trade several tokens at once - one order, one atomic settlement.
- [Partial Fills](https://tetrafi.mintlify.app/rfq-api/guides/partial-fills.md): Let an order settle for the size that's actually available - and get the rest back.
- [Migrating to the Router namespace](https://tetrafi.mintlify.app/rfq-api/guides/router-migration-guide.md): Move your integration from the legacy /api/v1 endpoints to /api/v1/router - at your own pace.
- [Short Expiry](https://tetrafi.mintlify.app/rfq-api/guides/short-expiry.md): Trade validity window against spread - tighter quotes for integrations that can act fast.
- [Speed-Optimised Quotes](https://tetrafi.mintlify.app/rfq-api/guides/speed-optimized-quotes.md): Bias the quote sweep toward latency - fastest answers first for time-critical flows.
- [Quotes](https://tetrafi.mintlify.app/rfq-api/api-reference/quote.md): Collect firm, escrow-backed quotes for a trade intent. Competing solvers and LPs each answer with a signed commitment priced from their own inventory - executable exactly as returned, no re-pricing, no last look - ranked best first. When no eligible counterparty can price the pair, the response is a…
- [Orders](https://tetrafi.mintlify.app/rfq-api/api-reference/order.md): Place an order against a firm quote. Send the chosen candidate back untouched as quoteResponse together with the taker signature over its escrow-v0 payload - signScheme EIP712 from an EOA by default, EIP1271 for smart-contract wallets - and an Idempotency-Key header so a retried POST can never doubl…
- [Order Status](https://tetrafi.mintlify.app/rfq-api/api-reference/order-status.md): Track a submitted order through its lifecycle. Statuses are lowercase: pending while the order progresses, then exactly one terminal state - settled or failed. Delivery-or-refund settlement means failed never strands funds: the escrowed input returns along the refund path.
- [Tradable Pairs](https://tetrafi.mintlify.app/rfq-api/api-reference/token-list.md): Every directional pair the workspace's solvers and LPs quote right now, each entry naming the exact input and output assets plus a corridor slug. Coverage follows LP inventory and listings - refresh at least daily instead of pinning the list.
- [Solvers](https://tetrafi.mintlify.app/rfq-api/api-reference/token-info.md): The counterparty roster your quote requests fan out to - every solver and LP that cleared the workspace's eligibility gates, with live pricing status, corridor coverage, and quoting history. An empty roster for a pair is what surfaces as a typed productUnavailable error on POST /quotes.
- [Preflight](https://tetrafi.mintlify.app/rfq-api/api-reference/supported-chains.md): Checks that your chosen quote is still submit-ready and returns nextActions - the ordered plan from selection to a submitted order: approvals to mine, the exact payload to sign, and where to send it. Settlement and approval contract addresses come only from here; never hardcode them.
- [Quotes](https://tetrafi.mintlify.app/api-reference/quotes.md): Request ranked, executable candidates for a trade intent. The router sweeps every eligible source - direct DEX liquidity, the RFQ venue, bridges, issuers, and fiat rails - and returns each candidate with its own stated guarantees. Several knobs from older quote APIs are deliberately absent here: the…
- [Submit Order](https://tetrafi.mintlify.app/api-reference/submit-order.md): Submit a signed order for settlement. Pass the selected candidate back unchanged together with the taker's EIP-712 signature over its escrow-v0 payload; the API verifies the signature against the integrityChecksum and, on apiSubmit candidates, lands the settlement transaction on-chain and carries th…
- [Order Status](https://tetrafi.mintlify.app/api-reference/order-status.md): Returns the lifecycle state of a submitted order: pending while it progresses, then the terminal settled or failed. The same transitions arrive as WebSocket events (order.created, order.settled, order.failed) on the orders:{id} topic. Because settlement is delivery-versus-payment, failed never means…
- [Tradable Pairs](https://tetrafi.mintlify.app/api-reference/tradable-pairs.md): Lists the corridors the router currently quotes, expressed over the production chain roster: ethereum (1), optimism (10), base (8453), and arc (5042). Authenticating with a tfk_test_ key exposes the sandbox roster as well - arc-testnet (5042002), solana-devnet (1399811151), tron-shasta, and adi-test…
- [Solver Roster](https://tetrafi.mintlify.app/api-reference/solver-roster.md): Lists the solvers and LPs your workspace can reach - the counterparties every quote request fans out to. An id appears here only after the counterparty clears the workspace's eligibility gates (onboarding, compliance, corridor coverage); `status` then says whether it is pricing right now. An empty e…
- [Preflight](https://tetrafi.mintlify.app/api-reference/preflight.md): Check that the candidate you selected is still submit-ready and receive nextActions - an ordered execution plan covering everything between selection and a submitted order: approvals to mine, deposits for bridge legs, the exact payload to sign, and where to send it. Actions marked frequency reusable…
- [Introduction](https://tetrafi.mintlify.app/propamm/introduction.md): propAMM (RFS) - request-for-stream execution, coming soon.
- [Introduction](https://tetrafi.mintlify.app/router-api/introduction.md): Route trades across every eligible liquidity source and choose from ranked executable candidates.
- [Quickstart](https://tetrafi.mintlify.app/router-api/quickstart.md): Your first Router API trade - candidates, preflight, signing, and settlement.
- [Quotes](https://tetrafi.mintlify.app/router-api/api-reference/quote.md): Request ranked, executable candidates for a trade intent. The router fans one intent out across direct DEX liquidity, the RFQ venue, bridges, issuers, and fiat rails, and every candidate comes back with its own stated guarantees: execution mode, guaranteed minimum output, fees, and expiry.
- [Orders](https://tetrafi.mintlify.app/router-api/api-reference/order.md): Submit a selected candidate for settlement together with the taker's EIP-712 signature over its escrow-v0 payload. The API checks the signature against the integrity checksum and, on apiSubmit candidates, lands the settlement transaction on-chain and carries the gas; an Idempotency-Key header makes…
- [Order Status](https://tetrafi.mintlify.app/router-api/api-reference/order-status.md): Read the lifecycle state of a submitted order: pending while it progresses, then the terminal settled or failed. The same transitions stream over WebSocket, and because settlement is delivery-versus-payment, a failed order refunds the escrowed input rather than losing funds.
- [Preflight](https://tetrafi.mintlify.app/router-api/api-reference/competition.md): Confirm a selected candidate is still submit-ready and receive nextActions, an ordered plan covering everything between selection and a submitted order: approvals to mine, bridge-leg deposits, the exact payload to sign, and where to send it. Reusable setup steps persist across trades and stop appear…
- [Tradable Pairs](https://tetrafi.mintlify.app/router-api/api-reference/supported-chains.md): List the corridors the router currently quotes, as a mapping of chain slugs to chain IDs. Production keys see the live roster; tfk_test_ keys additionally expose the sandbox networks.
- [Introduction](https://tetrafi.mintlify.app/price-api/introduction.md): Live indicative pricing, streamed continuously from TetraFi's liquidity network.
- [Quickstart](https://tetrafi.mintlify.app/price-api/quickstart.md): Get the price stream flowing - connect, decode, and read live depth in minutes.
- [Reference](https://tetrafi.mintlify.app/price-api/reference.md): Topic grammar, stream families, and expiry behavior for the price feed.
- [Pricing Unlisted Pairs](https://tetrafi.mintlify.app/price-api/guides/pricing-unlisted-pairs.md): Derive a cross rate for pairs the stream doesn't quote directly, by bridging two legs through a shared token.
- [Estimating VWAP](https://tetrafi.mintlify.app/price-api/guides/vwap-estimation.md): Work out what a given size would really cost from streamed depth - no firm quote needed.
- [Pricing](https://tetrafi.mintlify.app/price-api/api-reference/websockets/pricing.md)
- [Introduction](https://tetrafi.mintlify.app/trade-history-api/introduction.md): Query every trade your workspace has executed - detail, timelines, and exports across all supported chains.
- [Quickstart](https://tetrafi.mintlify.app/trade-history-api/quickstart.md): Pull your workspace's trade history - from filtered lists to single-trade detail.
- [Trades](https://tetrafi.mintlify.app/trade-history-api/api-reference/trades.md): List every trade your workspace has executed across all supported chains - filter by status, corridor, time range, LP, routing path, or USD amount, and page through results with limit and offset. Records come back newest first with per-leg asset detail.
- [Trade by ID](https://tetrafi.mintlify.app/trade-history-api/api-reference/trade-by-tx-hash.md): Fetch one trade's complete dossier, keyed by its order id: trade details, on-chain settlement transactions, LP info, and admin-only compliance sections, scoped to your workspace.
- [Trades](https://tetrafi.mintlify.app/api-reference/trades.md): Lists trades executed under a workspace across every supported chain in one call. Filter by status, corridor, RFC 3339 time range, LP, routing path, or USD amount range; sort by a whitelisted column; page through results with limit and offset.
- [Trade by ID](https://tetrafi.mintlify.app/api-reference/trade-by-id.md): Returns one trade's full dossier, keyed by its order id: trade details, on-chain settlement (including the settlement transaction hashes), LP info, and - for admin/owner callers - compliance, Travel Rule, proof, intent, and fee sections.
- [Export Trades](https://tetrafi.mintlify.app/api-reference/export-trades.md): Bulk export of the workspace's trade history for reconciliation and reporting. Accepts the same filters and sorting as the trade list (without pagination) and streams the result as CSV.
- [Support](https://tetrafi.mintlify.app/support.md): Every way to reach the humans behind the platform.
- [FAQ](https://tetrafi.mintlify.app/faq.md): Common questions about TetraFi, answered.
- [Security & Audits](https://tetrafi.mintlify.app/audits.md): TetraFi's security posture and audit program.
- [Brand Kit](https://tetrafi.mintlify.app/brand-kit.md): TetraFi brand colors, logos, and usage guidelines.
- [Privacy Policy](https://tetrafi.mintlify.app/privacy.md): TetraFi privacy policy.
- [Terms of Service](https://tetrafi.mintlify.app/terms.md): TetraFi terms of service.

## OpenAPI Specs

- [trade-history-api](https://tetrafi.mintlify.app/api-reference/specs/trade-history-api.json)
- [router-api](https://tetrafi.mintlify.app/api-reference/specs/router-api.json)
- [rfq-api](https://tetrafi.mintlify.app/api-reference/specs/rfq-api.json)
- [maker-api](https://tetrafi.mintlify.app/api-reference/specs/maker-api.json)

## AsyncAPI Specs

- [pricing-asyncapi](https://tetrafi.mintlify.app/api-reference/specs/pricing-asyncapi.yaml)
- [pricing-api-async](https://tetrafi.mintlify.app/api-reference/specs/pricing-api-async.json)