Skinport API Wrapper

Easy to use, fully typed wrapper for interacting with Skinport API.

• Official Skinport API documentation
• You can get your Skinport API key here

Installation

Install it from npm:

$ npm install skinport.js

Usage

ESM (ECMAScript Modules)

If you're using ESM ("type": "module" in package.json), you can directly import Skinport using import.

import Skinport from "skinport.js";

const skinport = new Skinport('clientId', 'clientSecret');

skinport.getItems();
skinport.getTransactions();
...

CommonJS (CJS)

If you're using CommonJS (require() based system), use await import().

(async () => {
  const { default: Skinport } = await import("skinport.js"); 

  const skinport = new Skinport('clientId', 'clientSecret');

  skinport.getItems();
  skinport.getTransactions();
  ...
})();

You don't need to pass clientId and clientSecret for methods which don't require authentication.

Initializing Websocket:

import Skinport from "skinport.js";

const skinport = new Skinport('clientId', 'clientSecret');

await skinport.initSocket();

const socket = skinport.socket;

Note: Trying to access .socket property before calling initSocket() will throw an error.

Documentation

API

const skinport = new Skinport('clientId', 'clientSecret');

• clientId: string (optional) (required for secured methods)
• clientSecret: string (optional) (required for secured methods)

---

Socket

Extends socket.io-client's Socket class. Will throw an error if accessed before calling initSocket().

await skinport.initSocket();
const socket = skinport.socket;

on(event, listener)

socket.on is io().on wrapper that includes typings support for Skinport websocket events.

socket.on(event, listener);

• event: string (required)
  • "saleFeed"
• listener: Function (required)

Event callback function has typings support.

socket.on("saleFeed", (data) => {
  /*
   * data extends SaleFeedData interface
   * 
   * Available properties: 
   * { 
   *      eventType: listed | sold,
   *      sales: any[],
   * }
   */
  const { eventType, sales } = data;
})

emit(event, data)

socket.emit is io().emit wrapper that includes typings support for Skinport websocket emitters.

socket.emit(event, data);

• event: string (required)
  • "saleFeedJoin"
• data: object (required)

Event emitter data has typings support.

socket.emit("saleFeedJoin", data);
/*
 * data extends SaleFeedJoinData interface
 * 
 * Available properties: 
 * { 
 *     appid: number,
 *     currency: string,
 *     locale: string
 * }
 */

---

initSocket()

Initializes the websocket

---

getItems(options)

Provides a list of items available on the marketplace, along with their associated metadata.

• options: object (optional)

Authorization: Not required

Property	Type	Required	Description
app_id	number	Optional	The app_id for the inventory's game (default 730).
currency	string	Optional	The currency for pricing (default EUR - Supported: AUD, BRL, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HRK, NOK, PLN, RUB, SEK, TRY, USD).
tradable	boolean	Optional	If true, it shows only tradable items on the market (default false).

const items = skinport.getItems({ app_id: 730, currency: "EUR", tradable: true });
console.log(items);

---

getSalesHistory(options)

Provides aggregated data for specific in-game items that have been sold on Skinport.

• options: object (optional)

Authorization: Not required

Property	Type	Required	Description
market_hash_name	string	Optional	The item's names, comma-delimited.
app_id	number	Optional	The app_id for the inventory's game (default 730).
currency	string	Optional	The currency for pricing (default EUR - Supported: AUD, BRL, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HRK, NOK, PLN, RUB, SEK, TRY, USD).

const salesHistory = skinport.getSalesHistory({ market_hash_name: "Glove Case,★ Karambit | Slaughter (Minimal Wear)", app_id: 730, currency: "EUR" });
console.log(salesHistory);

---

getOutOfStock(options)

Provides information about in-game items that are currently out of stock on Skinport.

• options: object (optional)

Authorization: Not required

Property	Type	Required	Description
app_id	number	Optional	The app_id for the inventory's game (default 730).
currency	string	Optional	The currency for pricing (default EUR - Supported: AUD, BRL, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HRK, NOK, PLN, RUB, SEK, TRY, USD).

const outOfStock = skinport.getOutOfStock({ app_id: 730, currency: "EUR" });
console.log(outOfStock);

---

getTransactions(options)

Retrieves a paginated list of user account transactions, including details.

• options: object (optional)

Authorization: Required

Property	Type	Required	Description
page	number	Optional	Pagination Page (default 1).
limit	number	Optional	Limit results between 1 and 100 (default 100).
order	string	Optional	Order results by asc or desc (default desc).

const salesHistory = skinport.getSalesHistory({ market_hash_name: "Glove Case,★ Karambit | Slaughter (Minimal Wear)", app_id: 730, currency: "EUR" });
console.log(salesHistory);