Skip to main content
All API requests require authentication with an API key.

Required header

Getting your API key

1

Sign in

Log in to your Wasmou account.
2

Open API access

Go to API access in the sidebar. If you cannot see a key, API access is not enabled on your account yet: ask support.
3

Copy the key

The key is shown once on screen with a ready-made curl command.
4

Allow your server (recommended)

Add the IP address of the server that will call the API. Requests from any other address are refused.

Example request

GET /api/status is the only endpoint that works without a key.

Security best practices

IP allow-list

Configure allowed IP addresses in API access. When at least one address is set, only requests from those addresses are accepted. Wasmou reads the real client address behind Cloudflare (CF-Connecting-IP), so you only list your own server’s public IP.

Keep your key secret

Your key spends your wallet balance. Treat it like a password.
  • Never commit keys to version control.
  • Keep them in environment variables or a secrets manager.
  • Never ship a key in a mobile app, a browser page or a support chat. Call Wasmou from your own backend.
  • Use different keys for development and production if you have more than one.

Rotate regularly

Generate a new key from API access. A new key can be generated once every 24 hours; the old key stops working immediately, so deploy the new one right away.

Rate limiting

  • 60 requests per minute per API key.
  • Exceeding it returns 429 Too Many Requests.
  • Implement exponential back-off (details).

Common authentication errors