Documentation

API Reference

Complete reference for the Stablecoin Roadmap API. Build integrations, automate workflows, and access stablecoin data programmatically.

Quick Start

Get started with the API in minutes. All endpoints return JSON and support standard HTTP methods.

curl -X GET "https://api.stablecoinroadmap.com/v1/metrics" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Authentication

API Keys

All API requests require authentication using a Bearer token. You can generate API keys from your dashboard after requesting access.

Authorization Header

Authorization: Bearer YOUR_API_KEY

Best Practices

  • • Store keys securely in environment variables
  • • Rotate keys periodically
  • • Use separate keys for development and production
  • • Never expose keys in client-side code

Rate Limits

  • • Free tier: 100 requests/hour
  • • Pro tier: 10,000 requests/hour
  • • Enterprise: Custom limits
  • • Rate limit headers included in responses

Base URL

https://api.stablecoinroadmap.com/v1

All API endpoints are relative to this base URL. Use HTTPS for all requests.

API Endpoints

GET/metrics

Retrieve comprehensive stablecoin market metrics including supply, volume, and market cap data.

Query Parameters

  • timeframe - Data timeframe: 24h, 7d, 30d, 90d (default: 7d)
  • stablecoins - Comma-separated list of stablecoin symbols
  • include_chains - Include chain-specific breakdown (default: false)

Example Response

{
  "data": {
    "total_supply": "150000000000",
    "market_cap": "150000000000",
    "volume_24h": "45000000000",
    "stablecoins": [
      {
        "symbol": "USDT",
        "supply": "83000000000",
        "market_cap": "83000000000",
        "volume_24h": "25000000000"
      }
    ]
  },
  "timestamp": "2025-01-15T10:30:00Z"
}
GET/issuers

List all stablecoin issuers with their profiles, compliance status, and supported chains.

Query Parameters

  • type - Filter by issuer type: fiat-backed, crypto-backed, algorithmic
  • region - Filter by jurisdiction: US, EU, APAC, etc.
  • page - Page number for pagination (default: 1)
  • limit - Results per page (default: 20, max: 100)
GET/use-cases

Browse use case templates and implementation patterns for different industries.

POST/contracts/generate

Generate a new stablecoin smart contract based on configuration parameters.

Request Body

{
  "name": "MyStablecoin",
  "symbol": "MSC",
  "type": "fiat-backed",
  "features": {
    "pausable": true,
    "blacklistable": true,
    "mintable": true,
    "burnable": true
  },
  "compliance": {
    "kyc_required": true,
    "jurisdiction": "US"
  }
}
POST/contracts/simulate

Run simulation tests on generated contracts to verify functionality and security.

Response Codes

200Success - Request completed successfully
201Created - Resource created successfully
400Bad Request - Invalid parameters or request body
401Unauthorized - Missing or invalid API key
403Forbidden - Insufficient permissions
429Too Many Requests - Rate limit exceeded
500Internal Server Error - Server-side issue

SDKs & Libraries

We provide official SDKs for popular programming languages to simplify integration.

JavaScript/TypeScript

npm install @stablecoinroadmap/sdk

Python

pip install stablecoinroadmap

Go

go get stablecoinroadmap.com/sdk

Next Steps