API Examples
These examples demonstrate how to use the CLOBr API. Replace YOUR_API_KEY with your actual API key, which you can generate in your account settings.
Select an endpoint:
Select a programming language:
# Request score for a single token
curl -X GET "https://clobr.io/api/v1/score/9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump" \
-H "x-api-key: YOUR_API_KEY"Endpoint Overview
GET /score/:address Premium+
Get CLOBr score and price data for a single token. Simple REST endpoint for individual token lookups.
Premium tier: 12 requests per minute
POST /score Enterprise
Batch query CLOBr scores for up to 50 tokens at once. Perfect for efficient portfolio analysis or multi-token comparisons.
Enterprise tier required with custom rate limits
GET /top-scores Premium+
Returns the top 50 tokens ranked by CLOBr score. Great for discovering high-quality tokens with strong liquidity.
Premium tier: 12 requests per minute
GET /market-depth Premium+
Returns detailed market depth data for a single token. Supports filtering by exchange type, currency, and price range.
Premium: delayed data only. Enterprise: real-time data access
API Best Practices
- Batch requests using the /score endpoint to query up to 50 tokens at once for maximum efficiency.
- Cache responses when appropriate to minimize API usage and improve your application's performance.
- Implement error handling in your code to gracefully handle API rate limits and other potential errors.
- Use delayed data when real-time precision isn't required by setting
delayed=trueon market-depth calls. - Keep your API keys secure and never expose them in client-side code or public repositories.
- Monitor your usage via rate limit headers to ensure you stay within limits.