API reference

Every endpoint uses GET, needs no authentication and answers JSON with Cache-Control: no-store. Token tickers contain a slash and go in the path as they are, for example /trc20/usdt/create/. Tickers are lowercase and case-sensitive. Amounts are decimal strings in whole asset units, never JSON numbers. Request URLs may be at most 8192 bytes. Parameters that an endpoint does not list are refused. Use HTTPS and URL-encode every query value.

Request limits apply per client IP and callback host. Errors use {"status":"error","error":"<message>"}; see Errors.

Create and track a deposit address

Allocate or retrieve a permanent public deposit address

GET /{ticker}/create/

One payout per canonical ticker and callback pair; payout and callback options are immutable. Unknown parameters are rejected. Maximum URL length is 8192 bytes.

Parameters

Example request

curl -G "https://api.suawave.com/trc20/usdt/create/" \
  --data-urlencode "callback=https://shop.example/hook?order=1001&nonce=7f3a9c" \
  --data-urlencode "address=TXyzPayoutAddressExample0000000000000"

Response 200

Existing or newly allocated address.

{
  "status": "success",
  "address_in": "TDepositAddressExample0000000000",
  "address_out": "TXyzPayoutAddressExample0000000000000",
  "callback_url": "https://shop.example/hook?order=1001&nonce=7f3a9c",
  "minimum_transaction_coin": "10.000000",
  "fee_percent": "0.10",
  "fee_fixed_coin": "0.100000",
  "fee_network_coin": "1.000000",
  "coupon": "LAUNCH10"
}

Errors

Statuses 400, 429, 503 use the standard error body described in Errors.

Notes for create:

• The canonical pair of ticker and callback identifies the order permanently. Canonicalization lowercases the scheme and host, removes a trailing host dot and a default port, and uppercases percent escapes. Path and query order are kept.
• json=1 takes precedence over post=1. Without either, callbacks are delivered as GET.
• All options are fixed by the first call for a pair; later calls return the original options.
• Only one payout address is supported. Split payouts, caller-set confirmations, priority selection and multi-token acceptance are not available.

Read deposit forwarding and callback history

GET /{ticker}/logs/

Callback is canonicalized and syntax-validated as in create, without DNS resolution. At most the 100 most recent eligible deposits are returned. Only eligible deposits to the assigned address and ticker asset are listed. Held, rejected, orphaned and below-minimum transfers are excluded. Existing orders without deposits have an empty callbacks array. Only the callback query parameter is accepted.

Parameters

Example request

curl -G "https://api.suawave.com/trc20/usdt/logs/" \
  --data-urlencode "callback=https://shop.example/hook?order=1001&nonce=7f3a9c"

Response 200

Read-only deposit and delivery history of the 100 most recent deposits, oldest of those first.

{
  "status": "success",
  "address_in": "TDepositAddressExample0000000000",
  "address_out": "TXyzPayoutAddressExample0000000000000",
  "callback_url": "https://shop.example/hook?order=1001&nonce=7f3a9c",
  "notify_pending": true,
  "notify_confirmations": 19,
  "priority": "default",
  "callbacks": [
    {
      "txid_in": "9f2c1a0e5b7d4c3a8e6f1b2d3c4a5e6f7a8b9c0d1e2f30415263748596a7b8c9",
      "txid_out": "1a2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e7f809",
      "value_coin": "100.000000",
      "value_forwarded_coin": "98.200000",
      "confirmations": 21,
      "last_update": "2026-10-25T12:00:00Z",
      "result": "done",
      "fee_percent": "0.50",
      "fee_coin": "1.800000",
      "logs": [
        {
          "request_url": "https://shop.example/hook?order=1001&nonce=7f3a9c&address_in=TDepositAddressExample0000000000&coin=trc20_usdt&pending=0",
          "response_status": 200,
          "responses": "*ok*",
          "next_try": null,
          "pending": 0,
          "confirmed": 1
        }
      ]
    }
  ]
}

Errors

Statuses 400, 429, 503 use the standard error body described in Errors.

Notes for logs:

Entries are listed oldest first, at most the 100 most recent eligible deposits. Each entry has at most ten attempt logs, newest first. Deposits below the minimum are not listed.

Utilities

Get the public ticker minimum

GET /{ticker}/info/

No global info endpoint. Info query parameters are currently ignored.

Parameters

Example request

curl "https://api.suawave.com/trc20/usdt/info/"

Response 200

Ticker information.

{
  "status": "success",
  "coin": "USDT",
  "ticker": "trc20/usdt",
  "minimum_transaction_coin": "10.000000",
  "fee_percent": "0.20",
  "fee_fixed_coin": "0.300000",
  "fee_network_coin": "1.000000",
  "fee_promotion": "spring sale"
}

Errors

Statuses 400, 429, 503 use the standard error body described in Errors.

Quote the configured native forwarding fee ceiling

GET /{ticker}/estimate/

Returns a conservative ceiling of the forwarding fee in the chain's native coin (for example TRX or BNB), not in token units. It is a configured fee cap, not a live estimate, and has no fiat conversion. On EVM chains it caps gas cost; on resource-based chains it covers contract energy fees, while bandwidth, account activation and preparatory funding are separate. Returns 503 when no ceiling is available.

Parameters

Example request

curl "https://api.suawave.com/trc20/usdt/estimate/"

Response 200

Configured cap in native coin, excluding service fees. estimated_cost_currency is omitted.

{
  "status": "success",
  "estimated_cost": "15.000000"
}

Errors

Statuses 400, 429, 503 use the standard error body described in Errors.

Encode an existing public deposit address as a payment QR

GET /{ticker}/qrcode/

The address must be the address_in of an existing order for this ticker. Unknown, duplicate, empty and malformed parameters are rejected; maximum URL length is 8192 bytes. EVM tokens with value use an EIP-681 token transfer request with the token contract, chain ID and integer base units. Without value the payload is only the address. TRON always uses the plain address and omits the validated value, because wallet amount URI support is not assumed. Wallet support varies.

Parameters

Example request

curl -G "https://api.suawave.com/trc20/usdt/qrcode/" \
  --data-urlencode "address=TDepositAddressExample0000000000"

Response 200

PNG data URI and its exact encoded payment text.

{
  "status": "success",
  "qr_code": "data:image/png;base64,iVBORw0KGgo...",
  "payment_uri": "TDepositAddressExample0000000000"
}

Errors

Statuses 400, 429, 503 use the standard error body described in Errors.

Payment URI by network family:

The PNG is square, black on white, with a quiet zone of at least four modules. Its decoded text is exactly payment_uri.

Convert an amount between fiat and priced asset currencies

GET /convert/

Informational CoinGecko prices cached for a short time; never used for credited, fee or payout amounts. Fiat results use 2 decimals, token results the asset's decimals, half up. A missing or stale price returns 503, never a guessed value.

Parameters

Example request

curl -G "https://api.suawave.com/convert/" \
  --data-urlencode "value=100" \
  --data-urlencode "from=eur" \
  --data-urlencode "to=usd"

Response 200

Converted amount and the rate used.

{
  "status": "success",
  "value_coin": "108.695652",
  "exchange_rate": "1.086956521739"
}

Errors

Statuses 400, 429, 503 use the standard error body described in Errors.

Convert an amount into the ticker's asset

GET /{ticker}/convert/

Same rules as /convert/ with the ticker asset as target and its registry decimals as precision.

Parameters

Example request

curl -G "https://api.suawave.com/trc20/usdt/convert/" \
  --data-urlencode "value=100" \
  --data-urlencode "from=usd"

Response 200

Converted amount and the rate used.

{
  "status": "success",
  "value_coin": "108.695652",
  "exchange_rate": "1.086956521739"
}

Errors

Statuses 400, 429, 503 use the standard error body described in Errors.

Conversion rules, rounding and supported currencies are on the Price conversion page.

Get the RSA callback verification key

GET /pubkey/

Returns the PKIX PUBLIC KEY PEM used to verify callbacks, RSA with at least 2048 bits. The x-ca-signature header of a callback is a base64 RSA-SHA256 PKCS1v15 signature over the exact full GET URL or the raw POST body. Verify using your configured external origin, preserve query ordering, deduplicate uuid and acknowledge with HTTP 200 and *ok* within 30 seconds. Form and JSON POST are supported. Pending and confirmed events have distinct UUIDs.

Example request

curl "https://api.suawave.com/pubkey/"

Response 200

Public key only; never private key material.

{
  "status": "success",
  "pubkey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A...\n-----END PUBLIC KEY-----\n"
}

Errors

Statuses 429 use the standard error body described in Errors.