# Suawave API

> HTTP API for accepting crypto payments without registration or API keys: create a deposit address for a payout address and callback URL, receive signed callbacks.

The API base URL is https://api.suawave.com. Every public endpoint is a GET request and needs no authentication. Supported tickers: bep20/usdt, trc20/usdt. Callbacks carry an x-ca-signature header, an RSA-SHA256 signature that you verify with the public key from https://api.suawave.com/pubkey/.

## Docs

- [Overview](https://suawave.com/docs/raw/index.md): Documentation for the API that accepts crypto payments: deposit addresses, signed callbacks, fees and errors. No registration, no account, no API key.
- [Quick start](https://suawave.com/docs/raw/quickstart.md): Create a deposit address, show it to a payer and handle the signed callbacks, step by step with commands you can run.
- [API reference](https://suawave.com/docs/raw/api-reference.md): Every endpoint with its parameters, example requests and responses. All endpoints use GET and need no authentication.
- [Callbacks](https://suawave.com/docs/raw/callbacks.md): Callback payloads, transports, the retry schedule and how to acknowledge a callback so that it is not sent again.
- [Verify callback signatures](https://suawave.com/docs/raw/verify-signature.md): Verify the x-ca-signature header of every callback with the public key from the API. Working code in Go, C#, JavaScript and PHP.
- [Tickers and networks](https://suawave.com/docs/raw/tickers.md): Which assets you can accept, the ticker that names each network and asset, and the minimum deposit for each ticker.
- [Fees and minimums](https://suawave.com/docs/raw/fees.md): How the amount that reaches your payout address is computed: service fee, network fee, minimums and the default fee schedule.
- [Errors](https://suawave.com/docs/raw/errors.md): Status codes and JSON error bodies of the API, with what to do about each one.

## API

- [OpenAPI definition](https://suawave.com/docs/openapi.yaml): all endpoints, parameters and schemas

## Optional

- [Price conversion](https://suawave.com/docs/raw/conversion.md): Informational price conversion between fiat currencies and supported assets. It never changes what is credited, charged or paid out.
- [Glossary](https://suawave.com/docs/raw/glossary.md): Definitions of the terms used in this documentation: deposit address, payout address, callback, ticker, fees and the callback fields.
- [Full documentation](https://suawave.com/docs/llms-full.txt): every page in one markdown file