API Skins

AI agents

Give your agent CS2 skin prices

Everything an AI agent needs to look up prices on 20 marketplaces and run your trading robots: an OpenAPI document, llms.txt, and a tool definition to copy.

Machine-readable docs

Connecting an agent

  1. 1Sign in with Steam and make a key on the API docs page. The free plan includes 100 price requests a month.
  2. 2Keep the key in your agent's environment, never in the prompt: the agent calls a tool, your code adds the X-API-KEY header.
  3. 3Point the agent at https://api.apiskins.com, either by loading /openapi.json into your framework or with the tool below.

A price tool to copy

The definition the model sees (JSON Schema, works with Claude, OpenAI and most agent frameworks), and the function that runs it.

{
  "name": "get_cs2_skin_prices",
  "description": "Lowest listing of CS2 items on each marketplace, in USD, checked every hour.",
  "input_schema": {
    "type": "object",
    "properties": {
      "market_hash_names": {
        "type": "array",
        "items": { "type": "string" },
        "maxItems": 100,
        "description": "Exact Steam market names, e.g. \"AK-47 | Redline (Field-Tested)\""
      },
      "providers": {
        "type": "string",
        "description": "Comma separated marketplaces, e.g. \"cs_float,buff_163\". All when left out"
      }
    },
    "required": ["market_hash_names"]
  }
}
async function get_cs2_skin_prices({ market_hash_names, providers }) {
    const url = new URL("https://api.apiskins.com/v1/prices");
    for (const name of market_hash_names) url.searchParams.append("market_hash_name", name);
    if (providers) url.searchParams.set("providers", providers);

    const response = await fetch(url, { headers: { "X-API-KEY": process.env.API_SKINS_KEY } });
    return response.json();
}

Letting an agent trade

The same key manages your robots: list an account's inventory, put items up for sale, place buy orders and change their limits. The robot never sells under the minimum or buys over the maximum the agent sets, but those limits are real money: review what your agent may do before giving it write access.

Marketplace API keys are never handled through the API; accounts are connected on the robot's page by you. Every request counts toward your plan's per-minute rate limit, and a request over it answers 429 with Retry-After, which agents should wait out instead of retrying at once.

Ready to build?

Get a key and try the first request in a minute.