Skip to main content
Welcome to the CryptoMate API reference. This section documents every public endpoint grouped by product: Treasury, Active Management, Cards, and Management.

​
Base URLs

EnvironmentBase URL
Sandboxhttps://api.sandbox.cryptomate.me
Productionhttps://api.cryptomate.me
Always build and test against Sandbox first. See Quickstart for the full onboarding flow.

​
Authentication

All requests are authenticated with an API key sent in the X-API-KEY header. 
curl https://api.cryptomate.me/... \
  -H "X-API-KEY: $CRYPTOMATE_API_KEY"
Keys are issued from the CryptoMate Portal and can be scoped with feature-level permissions and IP allowlists. See API Keys & Access Security for details.

​
Request and response format

  • All request bodies and responses use JSON with snake_case field names.
  • Timestamps are ISO-8601 in UTC (e.g. 2026-04-21T12:34:56Z).
  • Monetary amounts are serialized as decimal numbers.

​
Errors

Failed requests return a JSON body with code and message. Each response (including webhooks) also includes an X-Trace-Id header that you should attach to any support request. 
{
  "code": "NOT_FOUND",
  "message": "Wallet with id `wallet_...` was not found."
}
For the full list of HTTP status codes and error codes, see Errors.

​
Idempotency

Write endpoints that mutate state (transfers, ramps, card operations) support idempotency via the Idempotency-Key header. Repeating a request with the same key within the idempotency window returns the original result instead of executing a second time.

​
Webhooks

Many workflows are asynchronous. Register a webhook endpoint from the Portal to receive real-time notifications about deposits, card authorizations, ramp completions, and more. See Webhooks for the payload format and event catalog.

​
Products

Treasury

Manage MPC accounts, wallets, tokens, and transactions across multiple blockchains.

Active Management

Centralize client deposits, run ramps, and manage a holding wallet architecture.

Cards

Issue virtual Visa cards backed by stablecoin collateral.

Management

Company, clients, bank accounts, blockchains, configurations, and contracted products.