Appearance
Deposit and withdrawal partners
Users on Textile FX deposit local currency into a stablecoin (today NGN → cNGN) or withdraw the other way. We show every integrated provider, ranked by what the user actually receives after your fees, then open the one they pick.
Quote
We call you as the user types and again every few seconds. Respond in under 2 seconds.
Given side (deposit or withdraw), fiat, token, amount, and chain, return the amount they receive after fees, the rate, min/max, and the fee. Liquidity and a completion rate help us rank you; if you don't have them we still list you.
Your paths can look however you like. These are examples of shapes that work, not a spec.
A sized quote is enough. Deposit amount is fiat; withdraw amount is token:
GET /quotes/buy?currency=ngn&token=cngn&fiat_amount=50000&token_network=bep20
GET /quotes/sell?currency=ngn&token=cngn&token_amount=50000&token_network=bep20Send back to_amount (what they receive), rate, and fee. If min/max live on a separate call:
GET /limits/buy?currency_symbol=ngn
GET /limits/sell?token_symbol=cngnA book plus an amount-aware rate also works:
GET /markets?token=CNGN&fiat=NGN&network=bnb-smart-chain&side=buy
GET /rates/bnb-smart-chain/CNGN/50000/NGN?side=buyBook rows should carry rate, min, max, balance, and a fee if you have one. The rates path amount is the token notional, not the fiat.
Public HTTP is fine. A secret key is fine too — we keep it on our server, never in the browser.
Checkout
We open you on the same chain we just quoted. Two shapes we already use:
An iframe we lock to one corridor (side, fiat, token, network, amount). Whitelist https://app.textilecredit.com. Let us bridge the user's connected wallet so they sign in their own wallet UI, not a login of yours. Post height, close, and transaction status back to the parent.
A script + public key. We initialize with side, currencies, amount, network, a unique reference we generate, and the destination address on deposit. Call us back on close and success.
You run KYC and the bank rail. We connect the wallet, rank the list, and open you.
Deposit amount is the fiat they pay. Withdraw amount is the token they send. Prefill Send, not Receive. Deposits must credit the connected wallet.
Send us
Corridors — fiat codes, token symbols and contracts, chain IDs, and the slugs your API uses for those. Which sides you cover.
Credentials — staging and production. Widget public key if you have one; quote private key if you need auth. Confirm the origin whitelist if you iframe.
Brand — display name, SVG logo, a support contact, and a staging flow we can click through.
We don't need webhooks or a full transaction API to list you.