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_KEYBest 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
All API endpoints are relative to this base URL. Use HTTPS for all requests.
API Endpoints
/metricsRetrieve 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 symbolsinclude_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"
}/issuersList all stablecoin issuers with their profiles, compliance status, and supported chains.
Query Parameters
type- Filter by issuer type: fiat-backed, crypto-backed, algorithmicregion- Filter by jurisdiction: US, EU, APAC, etc.page- Page number for pagination (default: 1)limit- Results per page (default: 20, max: 100)
/use-casesBrowse use case templates and implementation patterns for different industries.
/contracts/generateGenerate 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"
}
}/contracts/simulateRun simulation tests on generated contracts to verify functionality and security.
Response Codes
SDKs & Libraries
We provide official SDKs for popular programming languages to simplify integration.
JavaScript/TypeScript
npm install @stablecoinroadmap/sdkPython
pip install stablecoinroadmapGo
go get stablecoinroadmap.com/sdk