Skip to Content
Canonical source of truth stays in the repository docs. This site is the polished presentation layer.
Resource Reference

Resource Reference

This page is the method-level reference for the runtime SDK surface.

For the higher-level map of when to use each surface, see Resources, Workflows, And Surface Map. For builders and presets, see Helpers, Builders, And Constants. For minimal write payloads and caveats on mutation-heavy routes, see Write Flows And Payloads.

Main Entry Points

SymbolUse It ForNotes
CsfloatSdkthe normal application entrypointwires client, account, inventory, stall, listings, loadout, history, users, meta, and workflows
CsfloatHttpClientlow-level transport accessuseful for wrappers, custom base URLs, and metadata access
CsfloatSdkErrorthrown on transport or API failurespairs with isCsfloatSdkError()
LoadoutResourceadvanced direct access to the loadout resource classmost users reach it through sdk.loadout
WorkflowResourceadvanced direct access to the workflow classmost users reach it through sdk.workflows

sdk.meta

MethodReturnsUse It ForNotes
getSchema()Promise<CsfloatSchemaResponse>full public schema bootstrappairs with schema helper exports
getExchangeRates()Promise<CsfloatExchangeRatesResponse>exchange-rate lookuppublic route
getApp()Promise<CsfloatAppMetaResponse>app bootstrap metadatapublic route
getLocation()Promise<CsfloatLocationResponse>inferred location metadatapublic route
getSchemaBrowse(type)Promise<CsfloatSchemaBrowseResponse>grouped browse categories such as stickers or keychainstype is CsfloatSchemaBrowseType
getItemExampleScreenshot(params)Promise<CsfloatSchemaScreenshotResponse>example media lookup for a schema itemuse schema helpers to build final image URLs
getNotary()Promise<CsfloatNotaryMetaResponse>current notary-related capability flagsauthenticated/helper-adjacent
inspectItem(inspectLink)Promise<CsfloatInspectResponse>inspect-link lookup through the companion surfacethe SDK handles the required base URL and Origin header

Key types: CsfloatSchemaResponse, CsfloatSchemaBrowseType, CsfloatSchemaScreenshotParams, CsfloatInspectResponse

sdk.account

Profile And Account Snapshot

MethodReturnsUse It ForNotes
getMe()Promise<CsfloatMeResponse>authenticated account snapshotnormal authenticated bootstrap
updateMe(request)Promise<CsfloatMessageResponse>low-level profile/account patchingdirect wrapper over PATCH /me
setOffersEnabled(enabled)Promise<CsfloatMessageResponse>enable or disable offersconvenience wrapper over updateMe()
setStallPublic(isPublic)Promise<CsfloatMessageResponse>toggle public stall visibilityconvenience wrapper
setAway(isAway)Promise<CsfloatMessageResponse>update away statusconvenience wrapper
setMaxOfferDiscount(maxOfferDiscount)Promise<CsfloatMessageResponse>change account max-offer discountconvenience wrapper
updateTradeUrl(tradeUrl)Promise<CsfloatMessageResponse>set account trade URLconvenience wrapper
updateBackground(backgroundUrl)Promise<CsfloatMessageResponse>set profile background image URLlive-confirmed field on PATCH /me
updateUsername(username)Promise<CsfloatMessageResponse>update display usernameexact validation rules remain API-driven
verifyEmail(emailOrRequest, token?)Promise<CsfloatMessageResponse>request or confirm email verificationlow-level account verification helper
verifySms(phoneNumberOrRequest, token?)Promise<CsfloatMessageResponse>request or confirm phone verificationlow-level account verification helper
markNotificationsRead(lastReadId)Promise<CsfloatMessageResponse>update notification read receiptposts last_read_id
setMobileStatus(version?)Promise<CsfloatMessageResponse>send mobile client status heartbeatdefaults to "8.0.0"

Key types: CsfloatMeResponse, CsfloatUpdateMeRequest, CsfloatVerifyEmailRequest, CsfloatVerifySmsRequest, CsfloatMessageResponse

Trades And Steam Sync

MethodReturnsUse It ForNotes
getTrades(params?)Promise<CsfloatTradesResponse>list authenticated tradessupports CsfloatTradesParams
getTrade(tradeId)Promise<CsfloatTrade>fetch one trade detailtrade route detail lookup
getTradeBuyerDetails(tradeId)Promise<CsfloatTradeBuyerDetails>fetch the buyer-details side payloadseller/operator flow
syncSteamNewOffer(offerIdOrRequest)Promise<CsfloatMessageResponse>low-level Steam new-offer sync helperroute exists, business side effects remain partially mapped
syncSteamOffers(request)Promise<CsfloatMessageResponse>low-level Steam offer-status sync helperbrowser-observed support helper
acceptTrades(tradeIdsOrRequest)Promise<CsfloatTradeBatchResponse>bulk seller acceptancecan be account/state-sensitive
markTradesReceived(tradeIdsOrRequest)Promise<CsfloatTrade[]>bulk buyer receipt flowstate-gated by actual Steam offer lifecycle
markTradeReceived(tradeId)Promise<CsfloatTradeActionResponse>single buyer receipt flowlow-level single-trade route
acceptTrade(tradeId)Promise<CsfloatTrade>accept one queued tradeseller-side single trade flow
cancelTrades(tradeIdsOrRequest)Promise<CsfloatTradeBatchResponse>bulk seller cancel flowbundle-backed route
cancelTrade(tradeId)Promise<CsfloatMessageResponse>cancel one tradeseller-side single cancel flow
cannotDeliverTrade(tradeId)Promise<CsfloatTradeActionResponse>seller-side cannot-deliver flowlow-level failure path
disputeTrade(tradeId)Promise<CsfloatTradeActionResponse>open the browser-confirmed dispute routelow-level recovery path
rollbackTrade(tradeId)Promise<CsfloatTradeActionResponse>request rollback handlinglow-level recovery path
manualVerifyTrade(tradeId)Promise<CsfloatTradeActionResponse>trigger manual verification routelow-level verification path
verifyTradeRollback(tradeId)Promise<CsfloatTradeActionResponse>confirm rollback-oriented verification routelow-level verification path

Key types: CsfloatTradesParams, CsfloatTradesResponse, CsfloatTrade, CsfloatTradeActionResponse, AcceptTradesRequest, CsfloatTradeSteamStatusNewOfferRequest, CsfloatTradeSteamOfferSyncRequest

Write payload guide: Write Flows And Payloads

Offers

MethodReturnsUse It ForNotes
getOffers(params?)Promise<CsfloatOffersResponse>list authenticated offerspage-based profile flow
createOffer(request)Promise<CsfloatOffer>create a buyer-side offerrequest type is CreateOfferRequest
getOffer(offerId)Promise<CsfloatOffer>fetch one offer thread nodedirect offer lookup
acceptOffer(offerId)Promise<CsfloatAcceptOfferResponse>low-level accept route helperroute is implemented, happy-path shape still conservative
getOfferHistory(offerId)Promise<CsfloatOffer[]>load the offer thread historyhistorical offer chain
counterOffer(offerId, request)Promise<CsfloatOffer>seller-side counter offerrequest type is CounterOfferRequest
cancelOffer(offerId)Promise<CsfloatMessageResponse>cancel an offer threadclose/cancel flow
getOffersTimeline(params?)Promise<CsfloatOffersResponse>profile timeline-style offer feedlimit-focused snapshot helper

Key types: CsfloatOffersParams, CsfloatOffersResponse, CreateOfferRequest, CounterOfferRequest, CsfloatAcceptOfferResponse

Write payload guide: Write Flows And Payloads

Watchlist And Notifications

MethodReturnsUse It ForNotes
getWatchlist(params?)Promise<CsfloatListingsResponse>authenticated watchlist listing feedquery surface mirrors listing-style filters
iterateWatchlist(params?)AsyncGenerator<CsfloatListing>stream the cursor-based watchlistconvenience over paginateCursor()
getNotifications(params?)Promise<CsfloatNotificationsResponse>notifications timelinecursor-aware route; current live payload also includes latest_notification_id

Key types: CsfloatWatchlistParams, CsfloatListingsResponse, CsfloatNotificationsParams, CsfloatNotificationsResponse

Watchlist note: returned CsfloatListing rows can include reference, which carries the base/predicted price widget data used by the marketplace UI.

Transactions, Payments, And Status

MethodReturnsUse It ForNotes
getTransactions(params?)Promise<CsfloatTransactionsResponse>authenticated transactions feedpage/order/type filters supported
exportTransactions(year, month)Promise<string>monthly CSV exportfull past month only
getAccountStanding()Promise<CsfloatAccountStandingResponse>standing and account status lookupauthenticated
getMaxWithdrawable()Promise<CsfloatMaxWithdrawableResponse>payout-state lookuppayments helper
getPendingDeposits()Promise<CsfloatPendingDeposit[]>pending deposit listauthenticated
getPendingWithdrawals()Promise<CsfloatPendingWithdrawal[]>pending withdrawal listauthenticated
deletePendingWithdrawal(withdrawalId)Promise<CsfloatMessageResponse | null>cancel pending withdrawalresponse can be opaque/null
getExtensionStatus()Promise<CsfloatExtensionStatusResponse>extension version/permission metadataauthenticated
getMobileStatus()Promise<CsfloatMobileStatusResponse>current mobile status payloadauthenticated

Key types: CsfloatTransactionsParams, CsfloatTransactionsResponse, CsfloatAccountStandingResponse, CsfloatPendingDeposit, CsfloatPendingWithdrawal, CsfloatExtensionStatusResponse, CsfloatMobileStatusResponse

Buy Orders, Auto-Bids, And Tokens

MethodReturnsUse It ForNotes
getBuyOrders(params?)Promise<CsfloatBuyOrdersResponse>list account buy orderspage/order/limit profile flow
getBuyOrdersForInspect(inspectLink, limit?)Promise<CsfloatInspectBuyOrdersResponse>inspect-link oriented buy-order lookupwraps /buy-orders/item; entries can carry either expression or direct market_hash_name
getSimilarBuyOrders(request, limit?)Promise<CsfloatSimilarBuyOrdersResponse>similar order researchaccepts market_hash_name or expression-backed request shapes
createBuyOrder(request)Promise<CsfloatBuyOrder>create a market-hash or expression-backed orderrequest type is CreateBuyOrderRequest
updateBuyOrder(orderId, request)Promise<CsfloatBuyOrder>change an existing buy ordercurrently wraps the validated patch surface
deleteBuyOrder(orderId)Promise<CsfloatMessageResponse>remove an orderdelete lifecycle step
getAutoBids()Promise<CsfloatAutoBid[]>fetch auction auto-bidsauthenticated
deleteAutoBid(autoBidId)Promise<CsfloatMessageResponse>remove an auto-bidauthenticated
createRecommenderToken()Promise<CsfloatRecommenderTokenResponse>mint token for loadout companion writes/recommendationsfeeds sdk.loadout bearer flows
createNotaryToken()Promise<CsfloatNotaryTokenResponse>mint notary companion tokenhelper-adjacent account flow
createGsInspectToken()Promise<CsfloatGsInspectTokenResponse>mint companion inspect tokenadvanced companion use

Key types: CsfloatBuyOrdersParams, CsfloatBuyOrdersResponse, CreateBuyOrderRequest, UpdateBuyOrderRequest, SimilarBuyOrdersRequest, CsfloatAutoBid, CsfloatRecommenderTokenResponse, CsfloatNotaryTokenResponse, CsfloatGsInspectTokenResponse

Write payload guide: Write Flows And Payloads

sdk.inventory

MethodReturnsUse It ForNotes
getInventory()Promise<CsfloatInventoryResponse>authenticated inventory lookupsimple read-only resource

Inventory note: some CsfloatInventoryItem rows can include reference with the same base/predicted price metadata seen on listing responses.

sdk.users

MethodReturnsUse It ForNotes
getUser(userId)Promise<CsfloatUser>public user profile lookupuseful before stall or profile tooling

sdk.stall

MethodReturnsUse It ForNotes
getStall(userId, params?)Promise<CsfloatListingsResponse>fetch one public seller stallparams is CsfloatStallParams
iterateStall(userId, params?)AsyncGenerator<CsfloatListing>stream a cursor-based public stallconvenience over paginateCursor()

Key types: CsfloatStallParams, CsfloatListingsResponse, CsfloatListing

Stall note: stall listing rows use the same CsfloatListing shape as public search results and can also include reference.

sdk.listings

Public Reads, Watchlist Mutation, And Purchases

MethodReturnsUse It ForNotes
getListings(params?)Promise<CsfloatListingsResponse>public market search and scansthe main listing query surface
getPriceList()Promise<CsfloatPriceListEntry[]>public market-wide min-price indexpublic route
iterateListings(params?)AsyncGenerator<CsfloatListing>stream public listings across cursorsconvenience over paginateCursor()
getListingById(listingId)Promise<CsfloatListing>fetch one listingdirect item-page bootstrap read
getBids(listingId)Promise<CsfloatBid[]>auction bid historyauction listings only
getBuyOrders(listingId, params?)Promise<CsfloatBuyOrder[]>listing-specific buy-order insightaccepts optional limit
getSimilar(listingId)Promise<CsfloatListing[]>similar listing lookuppublic route
addToWatchlist(listingId)Promise<CsfloatMessageResponse>watchlist one listingauthenticated
removeFromWatchlist(listingId)Promise<CsfloatMessageResponse>unwatch one listingauthenticated
buyNow(request)Promise<CsfloatMessageResponse>purchase one or more direct-buy listingsrequest type is BuyNowRequest
placeBid(listingId, request)Promise<CsfloatAutoBid>set or replace an auction max-price bidrequest type is PlaceBidRequest
buyListing(contractId, totalPrice)Promise<CsfloatMessageResponse>buy one contract without building BuyNowRequest manuallyconvenience wrapper

Key types: CsfloatListParams, CsfloatListingsResponse, CsfloatListing, CsfloatPriceListEntry, CsfloatBid, BuyNowRequest, PlaceBidRequest

Listing note: CsfloatListing.reference can carry the same data shown by the marketplace reference widget: base_price, predicted_price, quantity, and the float-factor multiplier. Use the reference helpers from Helpers, Builders, And Constants if you want derived values such as item-factor amount or deal percentage.

Listing Writes

MethodReturnsUse It ForNotes
createListing(request)Promise<CsfloatListing>generic listing createdefaults type to "buy_now" when omitted
createBuyNowListing(request)Promise<CsfloatListing>ergonomic buy-now listing createwraps createListing()
createAuctionListing(request)Promise<CsfloatListing>auction listing createvalidates duration_days
createBulkListings(requests)Promise<CsfloatListing[]>bulk list multiple contractsrequires at least one item
updateBulkListings(modifications)Promise<CsfloatListing[]>bulk edit multiple listingscurrently centered on validated bulk modification semantics
deleteBulkListings(contractIds)Promise<CsfloatMessageResponse>bulk delist multiple contractsrequires at least one contract id
updateListing(listingId, request)Promise<CsfloatListing>patch one listinglow-level generic listing patch
updateListingPrice(listingId, price)Promise<CsfloatListing>change listing priceconvenience wrapper
updateListingDescription(listingId, description)Promise<CsfloatListing>change listing descriptionconvenience wrapper
updateListingMaxOfferDiscount(listingId, maxOfferDiscount)Promise<CsfloatListing>change max-offer discount on a listingconvenience wrapper
updateListingPrivate(listingId, isPrivate)Promise<CsfloatListing>toggle listing privacyconvenience wrapper
deleteListing(listingId)Promise<CsfloatListing | null>delist one listingdelete/unlist lifecycle step

Important validation notes:

  • createListing() rejects descriptions longer than 32 characters
  • auction duration_days must be one of 1, 3, 5, 7, 14

Key types: CreateListingRequest, CreateBuyNowListingRequest, CreateAuctionListingRequest, UpdateBulkListingRequest, UpdateListingRequest

Write payload guide: Write Flows And Payloads

sdk.history

MethodReturnsUse It ForNotes
getSales(marketHashName)Promise<CsfloatListing[]>recent sales for one market hash namehistory surface
getGraph(marketHashName, params?)Promise<CsfloatHistoryGraphPoint[]>graph/history pointsaccepts CsfloatHistoryGraphParams

Key types: CsfloatHistoryGraphParams, CsfloatHistoryGraphPoint

sdk.loadout

Public Loadout Reads

MethodReturnsUse It ForNotes
getLoadouts(params?)Promise<CsfloatUserLoadoutsResponse>general public loadout listingmain public companion entrypoint
getDiscoverLoadouts(params?)Promise<CsfloatUserLoadoutsResponse>discover-mode loadout listinjects the validated discover defaults
getSkinLoadouts(defIndex, paintIndex, params?)Promise<CsfloatUserLoadoutsResponse>search loadouts for one skinpairs def_index + paint_index correctly
getUserLoadouts(steamId)Promise<CsfloatUserLoadoutsResponse>loadouts for one userpublic route
getLoadout(loadoutId)Promise<CsfloatLoadoutResponse>fetch one loadout detailpublic route
cloneLoadout(recommenderToken, loadoutId, name?)Promise<CsfloatLoadoutResponse>read one loadout then create a copied versionconvenience multi-call helper

Recommender-Token Loadout Writes And Recommendations

MethodReturnsUse It ForNotes
getFavoriteLoadouts(recommenderToken)Promise<CsfloatFavoriteLoadoutsResponse>list favorited loadouts for a token holderbearer-token route
createLoadout(recommenderToken, request)Promise<CsfloatLoadoutResponse>create a loadoutbearer-token route
updateLoadout(recommenderToken, loadoutId, request)Promise<CsfloatLoadoutResponse>update a loadoutbearer-token route
deleteLoadout(recommenderToken, loadoutId)Promise<CsfloatMessageResponse>delete a loadoutbearer-token route
recommend(recommenderToken, request)Promise<CsfloatLoadoutRecommendationResponse>generic skin recommendation callbearer-token route
recommendForSkin(recommenderToken, defIndex, paintIndex, options)Promise<CsfloatLoadoutRecommendationResponse>ergonomic single-skin recommend helperwraps recommend()
recommendStickers(recommenderToken, request)Promise<CsfloatStickerRecommendationResponse>generic sticker recommendation callbearer-token route
recommendStickersForSkin(recommenderToken, defIndex, paintIndex, options)Promise<CsfloatStickerRecommendationResponse>ergonomic single-skin sticker helperwraps recommendStickers()
generateRecommendations(recommenderToken, request)Promise<CsfloatGenerateLoadoutRecommendationsResponse>broader loadout generation flowbearer-token route
favoriteLoadout(recommenderToken, loadoutId)Promise<CsfloatLoadoutFavoriteResponse>favorite one loadoutbearer-token route
unfavoriteLoadout(recommenderToken, loadoutId)Promise<CsfloatLoadoutFavoriteResponse>remove a favoritebearer-token route

Key types: CsfloatLoadoutListParams, CsfloatCreateLoadoutRequest, CsfloatUpdateLoadoutRequest, CsfloatLoadoutRecommendationRequest, CsfloatStickerRecommendationRequest, CsfloatGenerateLoadoutRecommendationsRequest

Write payload guide: Write Flows And Payloads

sdk.workflows

The workflow layer is documented in detail here:

Methods available:

  • getPublicMarketFeeds()
  • getAccountWorkspace()
  • getSingleSkinBuyOrderInsights()
Last updated on