Skip to main content

Welcome

Cashmere exposes two public REST surfaces to help you quote transfers and monitor network activity. Everything is designed to work alongside the on-chain smart contracts documented in the developer guides.

Base URLs

ServiceHostPurpose
Gas APIhttps://gas.cashmere.exchangeGenerate relayer fees, gas-drop quotes, and cryptographic signatures for smart contract calls.
Monitoring APIhttps://kapi.cashmere.exchangeRead-only analytics: transactions, points, leaderboards, wallet counts, and volumes.

Authentication

Both APIs are currently open and do not require API keys. Please be respectful with request volumes—reach out at [email protected] for high-throughput access.

Backend API Deep Dive

Endpoints, payloads, and implementation notes

Core Endpoints

Rate Limits

We monitor usage but do not enforce formal tiers yet. If you plan to exceed ~120 requests per minute consistently, please coordinate with the team so we can provision dedicated capacity.
The Gas API recalculates fees on every request. Avoid spamming duplicate calls; use the WebSocket feed to subscribe to fee updates instead.

Error Handling

Errors are returned as JSON with the following structure:
{
  "error": {
    "code": "INVALID_PARAMETER",
    "message": "Invalid source chain",
    "details": {}
  }
}

Error Codes

  • INVALID_PARAMETER – malformed or unsupported input
  • MISSING_PRICE_DATA – Gas API cache is incomplete (retry later)
  • UNKNOWN_DOMAIN – Source or destination domain not recognised
  • SERVER_ERROR – Internal error (contact support if persistent)

Response Format

All successful responses return JSON:
{
  "data": { ... }
}