API Interface: ISales

API overview

Method: GetSales v1

HTTP method: GET
https://api.opskins.com/ISales/GetSales/v1/

Gets a list of item sales for your account. This endpoint is paginated, and will return up to 10,000 results per page.

Input

Output

response is an array of sale objects, containing these properties:

Method: GetListingLimit v1

HTTP method: GET
https://api.opskins.com/ISales/GetListingLimit/v1/

Get the current limit of how many items you can list for sale in one request. This limit is subject to change periodically (usually it only goes up, but it is possible that we may need to decrease it at some point). This is not an account-based listing limit; this is only a limit on how many items can be listed in one sale queue (via the website) or one call to ListItems (via the API).

Input

none

Output

Method: ListItems v1

HTTP method: POST
https://api.opskins.com/ISales/ListItems/v1/

Lists between 1 and 50 items for sale (upper cap subject to change). This will fail if any of the items passed in already have sales with active trade offers out. If there's a matching sale for an item that doesn't have a trade offer out, it will automatically be deleted.

Input

Output

Method: EditPrice v1

HTTP method: POST
https://api.opskins.com/ISales/EditPrice/v1/

Edits the price of an item you currently have listed. If the item is in your OPSkins inventory, it lists it for sale.

Input

Output

Errors

Method: EditPriceMulti v1

HTTP method: POST
https://api.opskins.com/ISales/EditPriceMulti/v1/

Queue price updates for up to 500 items. On success, this method will return an HTTP 202 Accepted status code and will respond immediately. The actual price updates will be queued and will be processed in the background. This will fail if you attempt to queue a price update for an item which already has a queued price update. Price update errors will not be reported and will be silently dropped in the background. For example, requests to edit the prices of items you do not own or which do not exist will be accepted, but will not actually be processed.

Input

Output

none

Method: GetActiveTradeOffers v1

HTTP method: GET
https://api.opskins.com/ISales/GetActiveTradeOffers/v1/

Get the list of active trade offers which our bots have sent you.

Input

none

Output

Method: Search v1

HTTP method: GET
https://api.opskins.com/ISales/Search/v1/

Search active OPSkins listings for particular items. This endpoint is relatively heavily rate-limited. Currently, it is limited to 20 requests per minute. To prevent bot sniping, this endpoint will only return listings which have been publicly visible for at least ten minutes, and are not currently limited to Buyers Club members. This endpoint always returns 100 listings sorted from lowest to highest price.

Input is identical to that of the main site's search page. The most important parameters are listed here.

Input

Output

Method: BuyItems v1

HTTP method: POST
https://api.opskins.com/ISales/BuyItems/v1/

Purchase one or more items and deliver them to your OPSkins inventory. Once purchased, the item(s) can be delivered to your Steam inventory using IInventory/Withdraw. To prevent bot sniping, this endpoint will only purchase listings which have been publicly visible for at least ten minutes, and are not currently limited to Buyers Club members.

If this request succeeds, then it will contain a root-level balance property containing your new account balance after the purchase, in USD cents.

Input

Output

This article has been viewed 4,595 times.