Skinsty API

User Documentation

A practical guide to the main Skinsty API flows: browsing the catalog, buying items, listing skins for sale, managing wallet operations, and tracking trades.

Base URLhttps://api-market.skinsty.comBased on backend.skinsday-market

Some operations require an active Skinsty user session. In the browser it is sent automatically; integrations should use the same authenticated context where the user is signed in.

Quick Start

Load market items with POST /market or grouped catalog data with POST /market-group.
Open an item page with GET /item/:sku when you need a specific itemId or SKU.
Check item availability before payment with POST /market/check.
Create the purchase with POST /market/buy and track active trades with GET /market/trade/active.

Catalog and Search

Endpoints for market listing, grouped item results, item search, and available filters.

Flow

Show the storefront

Send provider, pagination, and filters to POST /market. Use /market-group or the group flag when equal items should be grouped.

Endpoints

Returns market items. Supports price, float, sticker, rarity, status, and sorting filters.

HTTP Request

POSThttps://api-market.skinsty.com/market

Public method

Request Parameters

Parameter	Required	Type	Description
`provider`	No	CSGO \| DOTA2 \| Rust \| TF2	Game or item provider.
`page / take`	No	number	Pagination. take is limited to 150.
`price / float / tags`	No	object	Price, float, and item attribute filters.

Request example

{
  "provider": "CSGO",
  "page": 1,
  "take": 24,
  "nameSearch": "AK-47",
  "price": { "from": 10, "to": 150 },
  "sort": { "price": "ASC" }
}

Response example

{
  "data": [{ "sku": "item_sku", "price": 42.5, "marketName": {} }],
  "meta": { "page": 1, "take": 24, "count": 128 }
}

Endpoints

Returns grouped market items for a compact storefront view.

HTTP Request

POSThttps://api-market.skinsty.com/market-group

Public method

Request Parameters

Parameter	Required	Type	Description
`group`	No	boolean	Groups equal items into a single row.

Request example

{
  "provider": "DOTA2",
  "page": 1,
  "take": 24,
  "group": true
}

Endpoints

Search suggestions by item name.

HTTP Request

GEThttps://api-market.skinsty.com/market/search?provider=CSGO&nameSearch=knife

Public method

Request Parameters

Parameter	Required	Type	Description
`provider`	Yes	string	Item provider.
`nameSearch`	Yes	string	Part of the item name.

Endpoints

Available filters for the selected provider.

HTTP Request

GEThttps://api-market.skinsty.com/filters?provider=CSGO

Public method

Request Parameters

Parameter	Required	Type	Description
`provider`	Yes	string	Provider to load filters for.

Item Details

Fetch a specific item, similar offers, and minimum prices for auto-trade flows.

Endpoints 1

Returns item details. Pass itemId when a specific listing is required.

HTTP Request

GEThttps://api-market.skinsty.com/item/:sku?id=:itemId

Public method

Request Parameters

Parameter	Required	Type	Description
`sku`	Yes	string	Item or group SKU.
`id`	No	string	Specific listing ID.

Endpoints 2

Returns similar items with filters and pagination.

HTTP Request

POSThttps://api-market.skinsty.com/similar-items/:sku

Public method

Request example

{
  "provider": "CSGO",
  "page": 1,
  "take": 12
}

Endpoints 3

Minimum market and auto-buy prices for the selected item.

HTTP Request

GEThttps://api-market.skinsty.com/market/trade/prices/:sku

Session required

Buying Items

Check item availability before purchase, create a buy operation, then track active trade offers.

Flow

Standard purchase

Send an array of SKU values to /market/check. If the items are available, send the same array to /market/buy. The user needs Steam configured and the extension online to complete the trade.

Endpoints

Checks whether items are available before buying.

HTTP Request

POSThttps://api-market.skinsty.com/market/check

Session required

Request Parameters

Parameter	Required	Type	Description
`sku`	Yes	string	SKU of the item to buy.

Request example

[
  { "sku": "item_sku_1" },
  { "sku": "item_sku_2" }
]

Endpoints

Creates a purchase and starts the trade queue.

HTTP Request

POSThttps://api-market.skinsty.com/market/buy

Session required

Request Parameters

Parameter	Required	Type	Description
`sku`	Yes	string	Item SKU. It is recommended to check it with /market/check first.

Request example

[
  { "sku": "item_sku_1" }
]

Endpoints

Current user active Steam trade offers.

HTTP Request

GEThttps://api-market.skinsty.com/market/trade/active

Session required

Inventory and Selling

Endpoints for loading user inventory, listing items on the market, and removing them from sale.

Endpoints 1

Returns the user Steam inventory with filters and pagination.

HTTP Request

POSThttps://api-market.skinsty.com/inventory

Session required

Request Parameters

Parameter	Required	Type	Description
`provider`	No	string	Game to load inventory for.
`status`	No	string \| string[]	Status of inventory or listed items.

Request example

{
  "provider": "CSGO",
  "page": 1,
  "take": 24,
  "status": "IN_STOCK"
}

Endpoints 2

Starts inventory refresh from Steam.

HTTP Request

GEThttps://api-market.skinsty.com/inventory/steam-fetch?provider=CSGO

Session required

Endpoints 3

Lists one or more items for sale.

HTTP Request

POSThttps://api-market.skinsty.com/inventory/item-to-market

Session required

Request Parameters

Parameter	Required	Type	Description
`items[].itemId`	Yes	string	Inventory item ID.
`items[].price`	No	number	Sale price.

Request example

{
  "items": [
    { "itemId": "steam_asset_id", "price": 25.5 }
  ]
}

Endpoints 4

Removes selected items from sale.

HTTP Request

POSThttps://api-market.skinsty.com/inventory/remove-item-from-market

Session required

Request example

{
  "items": [
    { "itemId": "steam_asset_id" }
  ]
}

Wallet and History

Balance, top-ups, withdrawals, internal transfers, and transaction history.

Endpoints 1

Current user wallet balance.

HTTP Request

GEThttps://api-market.skinsty.com/market/wallet/balance

Session required

Endpoints 2

Operation history: purchases, sales, top-ups, and withdrawals.

HTTP Request

POSThttps://api-market.skinsty.com/market/wallet/history

Session required

Request Parameters

Parameter	Required	Type	Description
`type`	No	BUY \| SELL \| REFILL \| WITHDRAW	History type.
`from / to`	No	Date	Date range.

Request example

{
  "type": "BUY",
  "page": 1,
  "take": 20,
  "sort": { "createdAt": "DESC" }
}

Endpoints 3

Available top-up methods and form fields.

HTTP Request

GEThttps://api-market.skinsty.com/wallet/refill/form?country=US

Session required

Endpoints 4

Creates a wallet top-up request.

HTTP Request

POSThttps://api-market.skinsty.com/wallet/refill/new?amount=50&currency=USD&country=US

Session required

Request Parameters

Parameter	Required	Type	Description
`amount`	Yes	number	Top-up amount.
`currency`	Yes	string	Payment currency.

Request example

[
  { "name": "email", "value": "[email protected]" }
]

Endpoints 5

Creates a withdrawal request. Payment password may be required.

HTTP Request

POSThttps://api-market.skinsty.com/wallet/withdraw/new?country=US

Session required

Request example

{
  "amount": 25,
  "currency": "USD",
  "email": "[email protected]",
  "form": []
}

Buy Requests and Bargains

Auto-buy requests, current user request list, and bargain offers for listed items.

Endpoints 1

Creates a buy request for an item by filters and price.

HTTP Request

POSThttps://api-market.skinsty.com/market/trade/new

Session required

Request Parameters

Parameter	Required	Type	Description
`provider`	Yes	string	Item provider.
`price`	Yes	{ from: number; to: number }	Price range for the request.
`countToBuy`	Yes	number	Number of items to buy.

Request example

{
  "provider": "CSGO",
  "nameSearch": "AK-47 | Redline",
  "price": { "from": 10, "to": 35 },
  "countToBuy": 1
}

Endpoints 2

Current user buy request list.

HTTP Request

POSThttps://api-market.skinsty.com/market/trade/list

Session required

Request example

{
  "page": 1,
  "take": 20,
  "price": "DESC"
}

Endpoints 3

Creates a bargain offer for a listed item.

HTTP Request

POSThttps://api-market.skinsty.com/market/bargain/new

Session required

Request Parameters

Parameter	Required	Type	Description
`itemId`	Yes	string	Market item ID.
`price`	Yes	number	Offered price.

Request example

{
  "itemId": "market_item_id",
  "price": 18.75
}

Endpoints 4

Incoming bargain offers for the user listed items.

HTTP Request

POSThttps://api-market.skinsty.com/market/bargain/income

Session required

Endpoints 5

Accepts a bargain offer. Requires the browser extension to be online.

HTTP Request

POSThttps://api-market.skinsty.com/market/bargain/accept

Session required

Request example

{
  "sku": "item_sku",
  "userId": "buyer_user_id"
}

Common Errors

401 Unauthorized

user is not authenticated or the session has expired.

400 Bad Request

required parameters are missing, the extension is offline, or the item is unavailable.

408 Request Timeout

the buy queue did not finish in time.

403 Forbidden

the action is blocked by security rules or user restrictions.