CF Benchmarks APIcfbenchmarks.com ↗
Access cryptocurrency prices, free float market cap, and full market cap data from the CF Benchmarks screener via a clean REST API.
What is the CF Benchmarks API?
The CF Benchmarks Screener API provides 2 endpoints that return current price, free float market cap, full market cap, and supply data for cryptocurrencies tracked by CF Benchmarks. Use get_asset_prices to retrieve targeted data for specific symbols like BTC, ETH, or SOL, or call get_all_screener_data to pull every available asset in one request. Each response includes a total count alongside a structured array of asset objects.
curl -X GET 'https://api.parse.bot/scraper/9aacffe1-af99-47ac-a22c-d59f9db897ef/get_asset_prices?assets=BTC%2CETH%2CSOL' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace cfbenchmarks-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: CF Benchmarks Crypto Screener — bounded, re-runnable."""
from parse_apis.cf_benchmarks_crypto_screener_api import CFBenchmarks, AssetNotFound
client = CFBenchmarks()
# List all available assets (capped to 5 for brevity)
for asset in client.assets.list(limit=5):
print(asset.asset, asset.price, asset.change_24h_pct)
# Search for specific assets by symbol
btc = client.assets.search(assets="BTC,ETH", limit=1).first()
if btc:
print(btc.asset, btc.price, btc.free_float_market_cap, btc.full_market_cap)
# Typed error handling
try:
result = client.assets.search(assets="ZZZZZ", limit=1).first()
print("result:", result)
except AssetNotFound as exc:
print(f"not found: {exc}, assets={exc.assets}")
print("exercised: assets.list / assets.search / AssetNotFound catch")
Get current price, free float market cap, and full market cap for specific cryptocurrency assets. Returns matching assets from the CF Benchmarks screener. Accepts a comma-separated list of asset symbols to filter. Each returned asset includes price, 24h change percentage, free float and full market cap, supply figures, and DACS category classification.
| Param | Type | Description |
|---|---|---|
| assets | string | Comma-separated list of asset symbols to retrieve (e.g. BTC,ETH,SOL). Case-insensitive. |
{
"type": "object",
"fields": {
"total": "integer count of returned assets",
"assets": "array of Asset objects with price, market cap, and supply data"
},
"sample": {
"data": {
"total": 1,
"assets": [
{
"asset": "BTC",
"price": "61578.85",
"category": "Settlement - Non-Programmable - Payment & Store of Value",
"currency": "USD",
"change_24h_pct": -1.87,
"full_market_cap": 1233527196021.62,
"fungible_supply": 20031669.9,
"free_float_supply": 14855893.62,
"free_float_market_cap": 914808844841.94
}
]
},
"status": "success"
}
}About the CF Benchmarks API
Endpoints and Parameters
The get_asset_prices endpoint accepts an optional assets parameter — a comma-separated list of ticker symbols (e.g., BTC,ETH,SOL) — and returns only the matching records from the CF Benchmarks screener. Symbol matching is case-insensitive. Each returned asset object includes price, free float market cap, full market cap, and supply figures, along with an integer total reflecting how many records matched.
The get_all_screener_data endpoint returns every asset in the screener, sorted alphabetically by symbol. An optional limit integer parameter caps the number of returned assets, which is useful for sampling the dataset or paginating client-side. The response shape is identical to get_asset_prices: a total field and an assets array of objects.
Response Fields
Both endpoints return the same asset object structure. Key fields include the asset's current price, free float market cap (based on circulating supply), and full market cap (based on total supply). This distinction between free float and full market cap is one of CF Benchmarks' primary data points, reflecting their focus on institutional-grade benchmark methodology.
Coverage and Data Source
CF Benchmarks is a regulated benchmark administrator known for providing index and pricing data used by institutional crypto products, including CME futures. The screener covers assets that CF Benchmarks tracks and publishes publicly. Not all cryptocurrencies in existence will appear — coverage is limited to assets within CF Benchmarks' published screener.
The CF Benchmarks API is a managed, monitored endpoint for cfbenchmarks.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when cfbenchmarks.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official cfbenchmarks.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Comparing free float vs. full market cap across multiple assets to assess supply-side dilution risk
- Screening for assets by current price to filter candidates for portfolio construction
- Pulling BTC and ETH prices from a regulated benchmark source for trading dashboards
- Monitoring market cap rankings using alphabetically ordered
get_all_screener_dataoutput - Enriching crypto portfolio trackers with CF Benchmarks pricing as a secondary reference
- Feeding institutional-grade price data into quantitative models that require benchmark-sourced inputs
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does CF Benchmarks have an official developer API?+
What is the difference between free float market cap and full market cap in these responses?+
assets array in both endpoints returns both values. Free float market cap is calculated using the portion of supply actively in circulation (excluding locked, reserved, or non-tradeable tokens). Full market cap uses the total supply, including all tokens regardless of liquidity status. CF Benchmarks publishes both figures as part of their screener methodology.Can I retrieve historical price or market cap data with this API?+
get_asset_prices and get_all_screener_data return current snapshot data only — there are no date range or historical parameters. You can fork this API on Parse and revise it to add a historical data endpoint if that capability becomes available or an alternate source is identified.Does the API return trading volume or price change percentages?+
How many assets does `get_all_screener_data` return by default?+
limit parameter can be used to cap the result count. The total field in the response always reflects how many records were actually returned.