# Textile FX

> Textile FX is a non-custodial on-chain FX rail. It swaps local-currency and asset-backed stablecoins — cNGN (Nigerian naira), wARS (Argentine peso), wBRL and BRLA (Brazilian real), and WETH — against USD stablecoins (USDT, USDC). Every swap solicits a firm quote for your size and settles in a single on-chain transaction.

Moving money between a local currency and dollars normally means correspondent banks, OTC desks, and multi-day settlement. Textile FX replaces that with a request-for-quote venue per corridor: you name a size, makers price it, and the trade settles immediately. Rates and fees are on-chain and verifiable before you commit. Textile never takes custody of funds or keys — settlement runs through Uniswap's audited contracts, and every write path hands you an unsigned transaction or EIP-712 payload that your own wallet signs.

## Two ways to trade

- **Swap** — solicit a firm quote for the exact size you typed. One transaction, funds land in your wallet immediately. [Swap now](https://app.textilecredit.com/s/swap)
- **Limit order** — name your own rate. The order waits gaslessly until a maker takes it or it expires. [How limit orders work](https://docs.textilecredit.com/guides/how-to-place-a-limit-order)

## Live corridors

Deep links open the swap pre-filled with that pair.

- [cNGN → USDT on BSC](https://app.textilecredit.com/s/swap?sell=cNGN&buy=USDT&chainId=56) — Nigerian naira to dollars, and [USDT → cNGN](https://app.textilecredit.com/s/swap?sell=USDT&buy=cNGN&chainId=56)
- [cNGN → USDT on Celo](https://app.textilecredit.com/s/swap?sell=cNGN&buy=USDT&chainId=42220) and [USDT → cNGN](https://app.textilecredit.com/s/swap?sell=USDT&buy=cNGN&chainId=42220)
- [wARS → USDT on Celo](https://app.textilecredit.com/s/swap?sell=wARS&buy=USDT&chainId=42220) — Argentine peso, and [USDT → wARS](https://app.textilecredit.com/s/swap?sell=USDT&buy=wARS&chainId=42220)
- [wBRL → USDT on Celo](https://app.textilecredit.com/s/swap?sell=wBRL&buy=USDT&chainId=42220) — Brazilian real, and [USDT → wBRL](https://app.textilecredit.com/s/swap?sell=USDT&buy=wBRL&chainId=42220)
- [USDC → USDT on Celo](https://app.textilecredit.com/s/swap?sell=USDC&buy=USDT&chainId=42220) and [USDT → USDC](https://app.textilecredit.com/s/swap?sell=USDT&buy=USDC&chainId=42220)
- [WETH → USDT on Ethereum](https://app.textilecredit.com/s/swap?sell=WETH&buy=USDT&chainId=1) — wrapped ether, and [USDT → WETH](https://app.textilecredit.com/s/swap?sell=USDT&buy=WETH&chainId=1)

This list is the public Swap catalog. The [app](https://app.textilecredit.com/s/swap) and [rates feed](https://api.textilecredit.com/tickers) may still show other deployed pairs that we do not document here.

## API

Base URL `https://api.textilecredit.com`. Non-custodial: the API never signs anything or holds funds.

- [API overview](https://docs.textilecredit.com/api/): what v2 is, why v1 is closed, shared conventions
- [v2 RFQ](https://docs.textilecredit.com/api/v2/): the current API and the public Swap venue. Solicit a firm quote from market makers for an exact size. One executable quote or a clear no-quote, native exact-output. Any partner key reaches it.
- [RFQ endpoints](https://docs.textilecredit.com/api/v2/rfq): preview, request, cancel, submit, status, with a full TypeScript walkthrough
- [Authentication](https://docs.textilecredit.com/api/v2/authentication): a partner API key replaces the wallet signature. Keyless callers sign a short proof of control instead.
- [Webhooks](https://docs.textilecredit.com/api/v2/webhooks), [Errors & limits](https://docs.textilecredit.com/api/v2/errors)
- [v1 (deprecated)](https://docs.textilecredit.com/api/v1/): closed to new integrations, served only for those already on it. Limit orders still run here: [Limit orders](https://docs.textilecredit.com/api/v1/limit-orders), [Authentication](https://docs.textilecredit.com/api/v1/authentication), [Errors](https://docs.textilecredit.com/api/v1/errors), [Rate limits](https://docs.textilecredit.com/api/v1/rate-limits). Do not build new work on it.
- [Rates feed](https://docs.textilecredit.com/api/rates): public, no-auth live rates and trade history for every corridor
- Machine-readable: [OpenAPI v1](https://docs.textilecredit.com/openapi.json), [OpenAPI v2](https://docs.textilecredit.com/openapi-v2.json), [Postman collection](https://docs.textilecredit.com/textile-fx.postman_collection.json)
- [Testnet (BSC chain 97)](https://docs.textilecredit.com/testnet): faucet tokens and test keys before going live

## Documentation

- [What is Textile FX?](https://docs.textilecredit.com/): overview of the product and live corridors
- [How it works](https://docs.textilecredit.com/how-it-works): RFQ — firm quote for your size, settled in one transaction
- [Fees](https://docs.textilecredit.com/fees): the per-chain taker fee and the filler's spread
- [Protocol overview](https://docs.textilecredit.com/protocol/): what a firm quote is, who runs the liquidity, and where the trust sits
- [Settlement](https://docs.textilecredit.com/protocol/settlement): Uniswap's audited reactor and Permit2, and what one transaction actually does
- [Operator Vault](https://docs.textilecredit.com/protocol/operator-vault/): fund a maker without giving up custody. Private alpha.
- [Address book](https://docs.textilecredit.com/protocol/address-book): deployed contract addresses per chain
- [Glossary](https://docs.textilecredit.com/glossary): corridors, fillers, taker fee, and the rest of the vocabulary
- [Full docs corpus in one file](https://docs.textilecredit.com/llms-full.txt) and its [index](https://docs.textilecredit.com/llms.txt)

## Guides

- [How to swap](https://docs.textilecredit.com/guides/how-to-swap): convert a local-currency stablecoin to USDT (or back) at a firm quote
- [How to place a limit order](https://docs.textilecredit.com/guides/how-to-place-a-limit-order): rest an order at your own price
- [Reading your quote](https://docs.textilecredit.com/guides/reading-your-quote): effective rate, expected result, minimums, liquidity warnings
- [Preferred and restricted liquidity](https://docs.textilecredit.com/guides/preferred-liquidity): route through your own wallets first
- [RFQ on testnet with curl](https://docs.textilecredit.com/guides/bsc-testnet-rfq): the whole v2 flow on BSC testnet, from preview to settlement
- [How to become a filler](https://docs.textilecredit.com/guides/how-to-become-a-filler): run Stitch, quote both sides, earn the spread
- [Quoting Swap](https://docs.textilecredit.com/guides/quoting-the-order-book): spreads, liquidity caps, and answering RFQ

## Chains

BNB Smart Chain (56), Ethereum (1), Celo (42220), Base (8453), Polygon (137). BSC testnet (97) for integration testing.

## Optional

- [Blog](https://blog.textilecredit.com/): launches, corridor announcements, partner integrations
- [X / Twitter](https://x.com/Textileprotocol)
- [LinkedIn](https://www.linkedin.com/company/textilecredit)
- [Telegram](https://t.me/textileprotocol)
- Contact: contact@textilecredit.com