API reference

Simple payments API

Base URL same origin or https://api.chainsplit.io. No version prefix. No API key for the payment flow. HTTPS only.

Identity

Harden the callback with an unguessable nonce that you store server-side and verify on receipt.

Create payment address

GET /{ticker}/create/

QueryRequiredNotes
callbackyesURL-encoded HTTPS endpoint. Keep it unique.
addressyesYour receiving wallet for this ticker.
callback_idnoMerchant reference, echoed back.
pendingno1 to receive mempool webhooks.
confirmationsnoOverride default confirmations.
postno1 sends webhook as POST.
jsonno1 sends JSON body (implies POST).
convertno1 includes fiat conversions.
curl -G /erc20/usdt/create/ \
  --data-urlencode "address=0xYourUsdtWallet" \
  --data-urlencode "callback=https://merchant.tld/webhook?callback_id=ord_1842&nonce=u9f3" \
  --data-urlencode "pending=1" \
  --data-urlencode "json=1"

Tickers

v1 matches CryptAPI on four EVMs: Ethereum, BNB Smart Chain, Arbitrum, Polygon. Paths are drop-in (erc20/usdt, arbitrum/usdc.e). Bitcoin, Solana and Tron are not in this API yet.

Ethereum chainId 1

AssetTicker
DAI on Ethereumerc20/dai
LINK on Ethereumerc20/link
mUSD on Ethereumerc20/musd
ONDO on Ethereumerc20/ondo
PEPE on Ethereumerc20/pepe
POL on Ethereumerc20/pol
PYUSD on Ethereumerc20/pyusd
SHIB on Ethereumerc20/shib
TRX on Ethereumerc20/trx
USD1 on Ethereumerc20/usd1
USDC on Ethereumerc20/usdc
USDT on Ethereumerc20/usdt
Wrapped XRP on Ethereumerc20/wxrp
ARB on Ethereumerc20/arb
BNB on Ethereumerc20/bnb
cbBTC on Ethereumerc20/cbbtc
Ethereumeth
1INCH on Ethereumerc20/1inch

BNB Smart Chain chainId 56

AssetTicker
1INCH on BNBbep20/1inch
ADA on BNBbep20/ada
BNBbep20/bnb
BTCB on BNBbep20/btcb
CAKE on BNBbep20/cake
DAI on BNBbep20/dai
DOGE on BNBbep20/doge
ETH on BNBbep20/eth
LTC on BNBbep20/ltc
PHPt on BNBbep20/phpt
SHIB on BNBbep20/shib
TRX on BNBbep20/trx
USD1 on BNBbep20/usd1
USDC on BNBbep20/usdc
USDT on BNBbep20/usdt
XRP on BNBbep20/xrp

Arbitrum One chainId 42161

AssetTicker
ARBarbitrum/arb
DAI on Arbitrumarbitrum/dai
ETH on Arbitrumarbitrum/eth
LINK on Arbitrumarbitrum/link
PEPE on Arbitrumarbitrum/pepe
PYUSD on Arbitrumarbitrum/pyusd
USDC on Arbitrum (native)arbitrum/usdc
USDC.e on Arbitrum (bridged)arbitrum/usdc.e
USDT0 on Arbitrumarbitrum/usdt0

Polygon chainId 137

AssetTicker
USDC.e on Polygon (bridged)polygon/usdc.e
USDT on Polygonpolygon/usdt
WETH on Polygonpolygon/weth
AVAX on Polygonpolygon/avax
POLpolygon/pol
USDC on Polygon (native)polygon/usdc

Other endpoints

See also Fees and the optional merchant dashboard.