CSFloat APIcsfloat.com ↗
Fetch the 5 most recently listed CS2 skins on CSFloat, including item names and USD prices. Filter by minimum price in cents.
What is the CSFloat API?
The CSFloat API gives you access to the most recent CS2 skin listings on the CSFloat marketplace through 1 endpoint, get_newest_items. Each call returns up to 5 buy-now listings, with each item's market hash name and price in USD. Use the optional min_price parameter to filter out listings below a target price threshold.
curl -X GET 'https://api.parse.bot/scraper/ae7393e4-1d3e-4d8a-9fe2-64675597b454/get_newest_items?min_price=500' \ -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 csfloat-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: CSFloat SDK — browse newest CS2 skin listings with price filtering."""
from parse_apis.csfloat_market_newest_items_api import CSFloat, MinPrice, RateLimited
client = CSFloat()
# List newest items with default minimum price filter
for listing in client.listings.list(min_price=MinPrice._500, limit=5):
print(listing.name, listing.price)
# Use a higher price floor to find premium listings only
premium = client.listings.list(min_price=MinPrice._10000, limit=3).first()
if premium:
print(f"Premium find: {premium.name} at ${premium.price:.2f}")
# Handle rate-limiting errors gracefully
try:
for item in client.listings.list(min_price=MinPrice._1000, limit=5):
print(item.name, item.price)
except RateLimited as exc:
print(f"Rate limited: {exc}")
print("exercised: listings.list with MinPrice enum, .first() drill-down, RateLimited error handling")
Get the 5 most recently listed buy-now items on the CSFloat marketplace. Returns each item's name and price in USD. The upstream API filters by minimum price in cents and sorts by most recent. The site enforces strict rate limiting; repeated calls within ~60 seconds may be temporarily blocked.
| Param | Type | Description |
|---|---|---|
| min_price | string | Minimum price filter in cents (e.g., '500' = $5.00, '10000' = $100.00). |
{
"type": "object",
"fields": {
"items": "array of objects each containing 'name' (string, market hash name) and 'price' (number, price in USD)",
"total_returned": "integer, number of items returned"
},
"sample": {
"data": {
"items": [
{
"name": "SSG 08 | Red Stone (Minimal Wear)",
"price": 13.18
},
{
"name": "★ Skeleton Knife | Rust Coat (Battle-Scarred)",
"price": 136.96
},
{
"name": "Music Kit | TWERL and Ekko & Sidetrack, Under Bright Lights",
"price": 8.53
}
],
"total_returned": 5
},
"status": "success"
}
}About the CSFloat API
What the API Returns
The get_newest_items endpoint returns the 5 most recently posted buy-now listings on the CSFloat CS2 skin marketplace. Each item in the response includes a name field (the market hash name, e.g. AK-47 | Redline (Field-Tested)) and a price field denominated in USD. The total_returned integer tells you exactly how many items were included in that response.
Filtering by Price
The optional min_price parameter accepts a string representing a price in cents. For example, passing '500' filters out any listing priced below $5.00, and '10000' restricts results to items priced at $100.00 or more. If omitted, no price floor is applied and all five newest listings are returned regardless of price.
Freshness and Rate Limiting
CSFloat enforces strict rate limiting on its marketplace. Repeated calls to get_newest_items within approximately 60 seconds may result in a temporary block. For monitoring use cases, spacing calls at least a minute apart is the practical approach. The endpoint reflects the live listing order on CSFloat, so results change as new skins are posted.
The CSFloat API is a managed, monitored endpoint for csfloat.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when csfloat.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 csfloat.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?+
- Alert a Discord bot whenever a CS2 skin matching a target name appears in the newest CSFloat listings
- Track the floor price of freshly listed skins by recording each item's
pricefield over time - Filter new listings above a set dollar amount using
min_priceto surface only premium skin drops - Build a price history chart for specific market hash names as they appear in recent listings
- Monitor listing velocity by counting how frequently specific skin names appear across polling intervals
- Compare CSFloat listing prices against other CS2 marketplaces for arbitrage identification
| 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 CSFloat have an official developer API?+
What exactly does `get_newest_items` return for each listing?+
name string (the market hash name of the skin) and a price number in USD. The response also includes a total_returned integer indicating how many items were included, which will be at most 5.Does the API return float values, wear category, or seller information?+
Can I retrieve more than 5 listings or paginate through older items?+
How should I handle the rate limiting from CSFloat?+
get_newest_items is called repeatedly within roughly 60 seconds. Spacing polls at least one minute apart is advisable. If your use case requires higher-frequency monitoring, you will likely encounter blocks that are outside this API's control.