Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.skinshark.gg/llms.txt

Use this file to discover all available pages before exploring further.

Use v2 equivalents when possible:
  • GET /v1/market/listings -> GET /v2/market/listings
  • GET /v1/market/search -> GET /v2/market/search
  • GET /v1/market/search/suggestions -> GET /v2/market/search/suggestions
  • POST /v1/market/buy -> POST /v2/market/buy

​
GET /v1/market/listings

​
Query type

interface ListingsLegacyQuery {
  item: string;
  page?: number;
  delivery?: 2;
}

​
Response type

type ListingsLegacyResponse = ApiSuccess<{
  listings: Array<Record<string, unknown>>;
  steamPrice: number | null;
  totalSellCount: number;
  message: string;
}>;

​
Example

curl --request GET \
  --url "https://api.skinshark.gg/v1/market/listings?item=9e6e6b94cd0b562b&page=1" \
  --header "X-API-Key: <YOUR_API_KEY>"

​
GET /v1/market/search

​
Query type

interface SearchLegacyQuery {
  q?: string;
  start?: number;
  end?: number;
  minPrice?: number;
  maxPrice?: number;
  rarity?: string;
  team?: string;
  wear?: string;
  category?: string;
  tags?: string;
  paint_index?: string;
  weapon?: string;
  item_type?: string;
  sort?: 'abc' | 'priceAsc' | 'popularity' | 'priceDesc';
}

​
Example

curl --request GET \
  --url "https://api.skinshark.gg/v1/market/search?q=ak-47&weapon=AK-47&item_type=skin&rarity=Covert&team=Terrorist&wear=Factory%20New&category=Rifles&tags=StatTrak&minPrice=10&maxPrice=1000&sort=popularity" \
  --header "X-API-Key: <YOUR_API_KEY>"

​
GET /v1/market/search/suggestions

​
Query type

interface SearchSuggestionsLegacyQuery {
  q: string;
}

​
Example

curl --request GET \
  --url "https://api.skinshark.gg/v1/market/search/suggestions?q=ak-47" \
  --header "X-API-Key: <YOUR_API_KEY>"

​
POST /v1/market/buy

​
Request type

interface BuyLegacyRequest {
  itemId: string;
  price: number;
  method: 'balance';
  market: 'c5' | 'ecosteam';
  tradeURL?: string;
}

​
Example

curl --request POST \
  --url "https://api.skinshark.gg/v1/market/buy" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: <YOUR_API_KEY>" \
  --data '{
    "itemId": "1489853784346198016",
    "price": 0.45,
    "method": "balance",
    "market": "c5",
    "tradeURL": "https://steamcommunity.com/tradeoffer/new/?partner=1872111350&token=Vw8qSy_0"
  }'

​
GET /v1/market/item/{id}/overview

Get wear variants and in-stock summary for an item family.

​
Auth

  • Top-level partner API key required.

​
Example

curl --request GET \
  --url "https://api.skinshark.gg/v1/market/item/<ITEM_ID>/overview" \
  --header "X-API-Key: <TOP_LEVEL_PARTNER_KEY>"

​
GET /v1/market/item/{id}

Get single item metadata and fee-adjusted price fields.

​
Example

curl --request GET \
  --url "https://api.skinshark.gg/v1/market/item/<ITEM_ID>" \
  --header "X-API-Key: <YOUR_API_KEY>"

​
GET /v1/market/items

Get complete available item map with SkinSharkId linkage.

​
Example

curl --request GET \
  --url "https://api.skinshark.gg/v1/market/items?fastDeliveryOnly=true" \
  --header "X-API-Key: <YOUR_API_KEY>"