Textile FX

Appearance

Testnet (BSC) ​

Textile FX runs a sandbox on BNB Smart Chain testnet (chain ID 97) so you can wire up an integration, place real swaps and limit orders, and see fills settle — without touching mainnet funds. It mirrors the live BSC cNGN ↔ USDT corridor, using testnet tokens and test API keys.

Only instant swap and limit orders run on testnet. The lending/pool product is mainnet-only.

What's on testnet ​

  • One corridor: cNGN ↔ USDT, the same pair that's live on BSC mainnet.
  • cNGN is the real testnet token issued by the cNGN team.
  • USDT is the BNB Chain faucet USDT (0x3376…4dDd, 18 decimals) — the same token the testnet faucet dispenses. It has no value.
  • Everything settles through the same LimitOrderReactor design as mainnet — see Under the hood.

Rates on testnet are indicative and the order book is thin — it's for integration testing, not price discovery.

Get test tokens ​

You need three things in your wallet on BSC testnet:

  1. Testnet BNB for gas — grab it from the BNB Chain faucet.
  2. cNGN — mint from the cNGN faucet.
  3. USDT — needed only if you're selling USDT. Claim it from the same BNB Chain faucet (pick USDT in the token dropdown), or just start by selling cNGN.

Add BSC testnet to your wallet if it isn't already: RPC https://data-seed-prebsc-1-s1.binance.org:8545, chain ID 97, explorer testnet.bscscan.com.

Swap and limit orders in the app ​

The app flow is identical to mainnet — just connected to chain 97.

  1. Open app.textilecredit.com/s/swap and connect your wallet.
  2. Switch to BNB Smart Chain testnet when prompted.
  3. Pick cNGN → USDT (or the reverse), enter an amount, and either Submit swap (instant) or switch to Limit and rest an order at your price.

See How to swap and How to place a limit order for the full walkthrough — every step applies here.

Using the API ​

The REST API works on testnet with test keys. A test key can only target testnet chain IDs; a live key can only target mainnet chain IDs — the environments are isolated so a test integration can never touch real funds.

  • Pass chainId: 97 on the quote, swap, and limit-order endpoints.
  • Everything else — auth, request shapes, webhooks — is identical to production. See the API reference.
bash
# Quote a cNGN → USDT swap on BSC testnet with a test key
curl "https://api.textilecredit.com/v1/quote?chainId=97&sellToken=cNGN&buyToken=USDT&sellAmount=100000000" \
  -H "Authorization: Bearer $TEXTILE_TEST_API_KEY"

If a test key names a chain that has no corridor deployed yet, the API returns a 400 explaining that chain has no FX settlement contract — that's the same data-driven gate used on mainnet.

Contract addresses ​

Testnet addresses live in the address book alongside the mainnet deployments. Always verify against that page before interacting with a contract directly.

Next ​