Skip to main content
This quickstart walks you through the minimum steps to authenticate against the CryptoMate API and make your first call from the Sandbox environment.

​
1. Create an account

Sign up on the CryptoMate Portal and complete the onboarding for your organization. Once you’re in, you’ll have access to both environments:
  • Sandbox — safe playground, no real-world blockchain impact. Use it for development and testing.
  • Production — live transactions recorded on the main blockchain.
Always build and test your integration in Sandbox before switching to Production.

​
2. Generate an API key

From the Portal, open the API Keys section and create a new key. When creating the key you can:
  • Scope its permissions to only the products and actions your integration needs
  • Restrict it to a list of allowed IPs (recommended for backend services)
Copy the key immediately and store it in a secure location (environment variable, secret manager, etc.). You won’t be able to see it again.
Never commit API keys to source control or embed them in client-side code.
For a deeper dive, see API Keys & Access Security.

​
3. Make your first request

Include your API key in the X-API-KEY header of every request. 
curl https://api.cryptomate.me/v1/blockchains \
  -H "X-API-KEY: $CRYPTOMATE_API_KEY"
A successful response returns a 2xx status code and a JSON body. If something goes wrong, inspect the code and message fields and note the X-Trace-Id header — see Errors.

​
4. Configure a webhook (optional)

Most production integrations need to react to events asynchronously (a deposit arrives, a card transaction is authorized, a withdrawal completes). Expose an HTTPS endpoint and register it from the Portal to start receiving events. See Webhooks for the payload format and the list of available events.

​
5. Pick a product and go deep

Once you can authenticate and receive webhooks, continue with the guide for the product you’re integrating:

Treasury

Manage digital assets across multiple blockchains.

Active Management

Centralize client deposits with a holding wallet architecture.

Cards

Issue Visa cards backed by stablecoin collateral.

​
Next steps

API Reference

Browse every endpoint with request and response examples.