Portfolio API: Track and Value Your CS2 Items

The Portfolio API supports two complementary use cases: stateless valuation for one-off item lists you send in the request body, and saved portfolios that persist items and transactions under your account for ongoing tracking and historical analysis. Portfolio item limits are 1,000 items for Free and Starter accounts, 5,000 for Pro, and 10,000 for Quant — the same limit applies regardless of how items were added.

Portfolio management

POST /portfolio

Creates a new empty portfolio under your account. Auth: API key required

curl -sS -X POST \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Main Portfolio"}' \
  "https://api.cs2c.app/v1/portfolio"

import os

import cs2cap

configuration = cs2cap.Configuration(access_token=os.environ["CS2C_API_KEY"])

with cs2cap.ApiClient(configuration) as client:
    api = cs2cap.PortfolioApi(client)
    response = api.create_portfolio(
        cs2cap.PortfolioCreate(name="Main Portfolio")
    )

print(client.sanitize_for_serialization(response))

import { Configuration, PortfolioApi } from "cs2cap";

const accessToken = process.env.CS2C_API_KEY;

const api = new PortfolioApi(new Configuration({ accessToken }));
const response = await api.createPortfolio({ portfolioCreate: { name: "Main Portfolio" } });

console.log(response);

Request body

{
  "name": "Main Inventory"
}

string

required

Display name for the portfolio.

GET /portfolio

Returns all saved portfolios for your account. Auth: API key required

curl -sS \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  "https://api.cs2c.app/v1/portfolio"

import os

import cs2cap

configuration = cs2cap.Configuration(access_token=os.environ["CS2C_API_KEY"])

with cs2cap.ApiClient(configuration) as client:
    api = cs2cap.PortfolioApi(client)
    response = api.list_portfolios()

print(client.sanitize_for_serialization(response))

import { Configuration, PortfolioApi } from "cs2cap";

const accessToken = process.env.CS2C_API_KEY;

const api = new PortfolioApi(new Configuration({ accessToken }));
const response = await api.listPortfolios();

console.log(response);

string

Set to value to add total_value and change_24h_pct to every portfolio in the response. Omitted by default, since valuing every portfolio costs an extra lookup per portfolio.

string

default:"USD"

Portfolio base currency (ISO 4217). Values are returned in this currency.

string | null

Pinned pricing provider key, or null when the portfolio is valued at the best ask across all providers.

integer | null

Current total value in minor units of the base currency. Present only with include=value.

number | null

Percent change against the previous daily close. Present only with include=value, and null until a previous close exists.

DELETE /portfolio/:id

Permanently deletes a portfolio and all of its saved items and transactions. Auth: API key required

curl -sS -X DELETE \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  "https://api.cs2c.app/v1/portfolio/YOUR_PORTFOLIO_ID"

import os

import cs2cap

configuration = cs2cap.Configuration(access_token=os.environ["CS2C_API_KEY"])

portfolio_id = "YOUR_PORTFOLIO_ID"

with cs2cap.ApiClient(configuration) as client:
    api = cs2cap.PortfolioApi(client)
    response = api.delete_portfolio(
        portfolio_id
    )

print(client.sanitize_for_serialization(response))

import { Configuration, PortfolioApi } from "cs2cap";

const accessToken = process.env.CS2C_API_KEY;

const portfolioId = "YOUR_PORTFOLIO_ID";

const api = new PortfolioApi(new Configuration({ accessToken }));
const response = await api.deletePortfolio({ portfolioId });

console.log(response);

string

required

UUID of the portfolio to delete.

Valuation

POST /portfolio/value

Values a user-supplied item list using the current best ask across the selected providers. Use this for one-off valuations without creating a saved portfolio. Tiers: Free, Starter, Pro, Quant

curl -sS -X POST \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"item_id":4994,"quantity":2},{"item_id":12632,"quantity":5}],"currency":"USD"}' \
  "https://api.cs2c.app/v1/portfolio/value"

import os

import cs2cap

configuration = cs2cap.Configuration(access_token=os.environ["CS2C_API_KEY"])

with cs2cap.ApiClient(configuration) as client:
    api = cs2cap.PortfolioApi(client)
    response = api.value_portfolio(
        cs2cap.PortfolioRequest(
            items=[
                cs2cap.PortfolioRequestItem(item_id=4994, quantity=2),
                cs2cap.PortfolioRequestItem(item_id=12632, quantity=5),
            ],
            currency="USD",
        )
    )

print(client.sanitize_for_serialization(response))

import { Configuration, PortfolioApi } from "cs2cap";

const accessToken = process.env.CS2C_API_KEY;

const api = new PortfolioApi(new Configuration({ accessToken }));
const response = await api.valuePortfolio({
  portfolioRequest: {
    items: [
      { itemId: 4994, quantity: 2 },
      { itemId: 12632, quantity: 5 },
    ],
    currency: "USD",
  },
});

console.log(response);

array

required

Array of objects, each with item_id (integer) and quantity (integer). Maximum 100 items per request.

string[]

Optional provider filter. Omit to use all available providers.

string

default:"USD"

Target output currency (ISO 4217).

Request body

{
  "items": [
    { "item_id": 1, "quantity": 3 }
  ],
  "providers": ["steam", "buff163"],
  "currency": "USD"
}

Response example

{
  "meta": {
    "currency": "USD",
    "generated_at": "2026-03-24T12:00:00Z",
    "providers_queried": ["steam", "buff163"]
  },
  "data": {
    "line_items": [
      {
        "item_id": 1,
        "market_hash_name": "AK-47 | Redline (Field-Tested)",
        "phase": null,
        "quantity": 3,
        "best_ask": 2550,
        "item_value": 7650,
        "providers": []
      }
    ],
    "total_value": 7650,
    "items_valued": 1,
    "items_not_found": []
  }
}

array

Per-item valuation results.

Show line item properties

integer

Catalog item ID.

string

Full item name.

string | null

Phase variant, or null.

integer

Quantity from the request.

number

Best ask price for a single unit, in the requested currency’s minor units.

number

best_ask × quantity.

array

Per-provider breakdown when available.

number

Sum of all item_value entries.

integer

Number of items successfully priced.

array

Item IDs from the request that could not be matched in the catalog.

GET /portfolio/:id/value

Values all items currently in a saved portfolio using live market prices. Auth: API key required

curl -sS \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  "https://api.cs2c.app/v1/portfolio/YOUR_PORTFOLIO_ID/value?currency=USD&providers=buff163"

import os

import cs2cap

configuration = cs2cap.Configuration(access_token=os.environ["CS2C_API_KEY"])

portfolio_id = "YOUR_PORTFOLIO_ID"

with cs2cap.ApiClient(configuration) as client:
    api = cs2cap.PortfolioApi(client)
    response = api.get_portfolio_value(
        portfolio_id,
        currency="USD",
    )

print(client.sanitize_for_serialization(response))

import { Configuration, PortfolioApi } from "cs2cap";

const accessToken = process.env.CS2C_API_KEY;

const portfolioId = "YOUR_PORTFOLIO_ID";

const api = new PortfolioApi(new Configuration({ accessToken }));
const response = await api.getPortfolioValue({ portfolioId, currency: "USD" });

console.log(response);

string

required

UUID of the portfolio to value.

string

default:"USD"

Target output currency (ISO 4217).

string[]

Optional provider filter. Repeat to pass multiple values.

This is a live valuation based on current indexed prices, not a historical replay.

Import and export

POST /portfolio/:id/import

Imports items from your linked Steam inventory into a saved portfolio. If you omit asset_ids, the full inventory is imported. Auth: API key required + linked Steam account

curl -sS -X POST \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}' \
  "https://api.cs2c.app/v1/portfolio/YOUR_PORTFOLIO_ID/import"

import os

import cs2cap

configuration = cs2cap.Configuration(access_token=os.environ["CS2C_API_KEY"])

portfolio_id = "YOUR_PORTFOLIO_ID"

with cs2cap.ApiClient(configuration) as client:
    api = cs2cap.PortfolioApi(client)
    response = api.import_steam_inventory(
        portfolio_id,
        cs2cap.PortfolioImportRequest(),
    )

print(client.sanitize_for_serialization(response))

import { Configuration, PortfolioApi } from "cs2cap";

const accessToken = process.env.CS2C_API_KEY;

const portfolioId = "YOUR_PORTFOLIO_ID";

const api = new PortfolioApi(new Configuration({ accessToken }));
const response = await api.importSteamInventory({ portfolioId, portfolioImportRequest: {} });

console.log(response);

string

required

UUID of the destination portfolio.

Request body (optional asset filter and cost basis)

{
  "asset_ids": ["1234567890", "1234567891"],
  "prices": {
    "1234567890": 2550
  }
}

object

Optional per-unit purchase price in minor units, keyed by Steam asset ID. Every imported asset with a price also gets a matching buy transaction — dated today, marketplace steam, in the portfolio’s base currency — so the import carries cost basis. Assets you leave out are imported without one.

Items already saved under the same Steam asset ID are skipped automatically. Items that cannot be matched to a catalog entry are returned in unresolved and are not stored.

POST /portfolio/:id/import/csv

Uploads a CSV file to bulk import transactions or snapshot-style holdings into a portfolio. Auth: API key required

curl -sS -X POST \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  -F "file=@transactions.csv" \
  "https://api.cs2c.app/v1/portfolio/YOUR_PORTFOLIO_ID/import/csv"

string

required

UUID of the destination portfolio.

Both ledger and snapshot CSV formats are supported. The format is detected automatically from the CSV headers. Buy transactions imported from CSV can create missing portfolio items automatically.

GET /portfolio/:id/export

Downloads portfolio data as a CSV file. Auth: API key required

curl -sS \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  -o portfolio.csv \
  "https://api.cs2c.app/v1/portfolio/YOUR_PORTFOLIO_ID/export?type=transactions"

string

required

UUID of the portfolio to export.

string

default:"transactions"

Export format. One of: transactions, items.

Portfolio items

GET /portfolio/:id/items

Returns the items currently stored in a portfolio. Auth: API key required

curl -sS \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  "https://api.cs2c.app/v1/portfolio/YOUR_PORTFOLIO_ID/items"

import os

import cs2cap

configuration = cs2cap.Configuration(access_token=os.environ["CS2C_API_KEY"])

portfolio_id = "YOUR_PORTFOLIO_ID"

with cs2cap.ApiClient(configuration) as client:
    api = cs2cap.PortfolioApi(client)
    response = api.list_portfolio_items(
        portfolio_id
    )

print(client.sanitize_for_serialization(response))

import { Configuration, PortfolioApi } from "cs2cap";

const accessToken = process.env.CS2C_API_KEY;

const portfolioId = "YOUR_PORTFOLIO_ID";

const api = new PortfolioApi(new Configuration({ accessToken }));
const response = await api.listPortfolioItems({ portfolioId });

console.log(response);

string

required

UUID of the portfolio.

POST /portfolio/:id/items

Manually adds one item to a portfolio. Auth: API key required

curl -sS -X POST \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_id":4994,"quantity":2}' \
  "https://api.cs2c.app/v1/portfolio/YOUR_PORTFOLIO_ID/items"

import os

import cs2cap

configuration = cs2cap.Configuration(access_token=os.environ["CS2C_API_KEY"])

portfolio_id = "YOUR_PORTFOLIO_ID"

with cs2cap.ApiClient(configuration) as client:
    api = cs2cap.PortfolioApi(client)
    response = api.add_item_to_portfolio(
        portfolio_id,
        cs2cap.PortfolioAddItemRequest(item_id=4994, quantity=2),
    )

print(client.sanitize_for_serialization(response))

import { Configuration, PortfolioApi } from "cs2cap";

const accessToken = process.env.CS2C_API_KEY;

const portfolioId = "YOUR_PORTFOLIO_ID";

const api = new PortfolioApi(new Configuration({ accessToken }));
const response = await api.addItemToPortfolio({ portfolioId, portfolioAddItemRequest: { itemId: 4994, quantity: 2 } });

console.log(response);

string

required

UUID of the portfolio.

integer

Catalog item ID. Provide either item_id or market_hash_name.

integer

required

Number of units to add.

string

Phase variant for Doppler/Gamma items, or null.

Request body

{
  "item_id": 12632,
  "quantity": 2,
  "phase": null
}

DELETE /portfolio/:id/items/:entry_id

Removes a saved portfolio entry. Auth: API key required

curl -sS -X DELETE \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  "https://api.cs2c.app/v1/portfolio/YOUR_PORTFOLIO_ID/items/YOUR_ENTRY_ID"

import os

import cs2cap

configuration = cs2cap.Configuration(access_token=os.environ["CS2C_API_KEY"])

portfolio_id = "YOUR_PORTFOLIO_ID"
entry_id = "YOUR_ENTRY_ID"

with cs2cap.ApiClient(configuration) as client:
    api = cs2cap.PortfolioApi(client)
    response = api.remove_item_from_portfolio(
        portfolio_id,
        entry_id,
    )

print(client.sanitize_for_serialization(response))

import { Configuration, PortfolioApi } from "cs2cap";

const accessToken = process.env.CS2C_API_KEY;

const portfolioId = "YOUR_PORTFOLIO_ID";
const entryId = "YOUR_ENTRY_ID";

const api = new PortfolioApi(new Configuration({ accessToken }));
const response = await api.removeItemFromPortfolio({ portfolioId, entryId });

console.log(response);

string

required

UUID of the portfolio.

string

required

Portfolio entry UUID. This is the UUID assigned to the portfolio entry — it is not the catalog item_id.

entry_id is the portfolio entry UUID, not the catalog item_id. You can retrieve it from GET /portfolio/:id/items.

Transactions

GET /portfolio/:id/transactions

Returns the portfolio’s buy/sell ledger, newest first. Auth: API key required

curl -sS \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  "https://api.cs2c.app/v1/portfolio/YOUR_PORTFOLIO_ID/transactions"

import os

import cs2cap

configuration = cs2cap.Configuration(access_token=os.environ["CS2C_API_KEY"])

portfolio_id = "YOUR_PORTFOLIO_ID"

with cs2cap.ApiClient(configuration) as client:
    api = cs2cap.PortfolioApi(client)
    response = api.list_transactions(
        portfolio_id
    )

print(client.sanitize_for_serialization(response))

import { Configuration, PortfolioApi } from "cs2cap";

const accessToken = process.env.CS2C_API_KEY;

const portfolioId = "YOUR_PORTFOLIO_ID";

const api = new PortfolioApi(new Configuration({ accessToken }));
const response = await api.listTransactions({ portfolioId });

console.log(response);

string

required

UUID of the portfolio.

POST /portfolio/:id/transactions

Records a buy or sell transaction for an item in the portfolio. Auth: API key required

curl -sS -X POST \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_id":4994,"type":"buy","quantity":1,"price":53000,"date":"2026-03-15","currency":"USD"}' \
  "https://api.cs2c.app/v1/portfolio/YOUR_PORTFOLIO_ID/transactions"

import os

import cs2cap

configuration = cs2cap.Configuration(access_token=os.environ["CS2C_API_KEY"])

portfolio_id = "YOUR_PORTFOLIO_ID"

with cs2cap.ApiClient(configuration) as client:
    api = cs2cap.PortfolioApi(client)
    response = api.add_transaction(
        portfolio_id,
        cs2cap.TransactionCreateRequest(
            item_id=4994,
            type="buy",
            quantity=1,
            price=50000,
            currency="USD",
            transacted_at="2026-03-20T12:00:00Z",
        ),
    )

print(client.sanitize_for_serialization(response))

import { Configuration, PortfolioApi } from "cs2cap";

const accessToken = process.env.CS2C_API_KEY;

const portfolioId = "YOUR_PORTFOLIO_ID";

const api = new PortfolioApi(new Configuration({ accessToken }));
const response = await api.addTransaction({
  portfolioId,
  transactionCreateRequest: {
    itemId: 4994,
    type: "buy",
    quantity: 1,
    price: 50000,
    currency: "USD",
    transactedAt: new Date("2026-03-20T12:00:00Z"),
  },
});

console.log(response);

string

required

UUID of the portfolio.

integer

Catalog item ID. Provide either item_id or market_hash_name.

string

required

Transaction direction. One of: buy, sell.

integer

required

Number of units transacted.

number

required

Price per unit in the specified currency.

string

required

Transaction date in YYYY-MM-DD format.

string

Marketplace where the transaction occurred (e.g., skinport).

string

required

Currency for the price (ISO 4217).

Request body

{
  "item_id": 1,
  "type": "buy",
  "quantity": 1,
  "price": 2500,
  "date": "2026-03-24",
  "marketplace": "skinport",
  "currency": "USD"
}

Buy transactions can automatically create portfolio items for items not yet tracked in the portfolio.

PATCH /portfolio/:id/transactions/:tx_id

Partially updates an existing transaction. Auth: API key required

curl -sS -X PATCH \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"quantity":2,"price":52500}' \
  "https://api.cs2c.app/v1/portfolio/YOUR_PORTFOLIO_ID/transactions/YOUR_TX_ID"

import os

import cs2cap

configuration = cs2cap.Configuration(access_token=os.environ["CS2C_API_KEY"])

portfolio_id = "YOUR_PORTFOLIO_ID"
transaction_id = "YOUR_TRANSACTION_ID"

with cs2cap.ApiClient(configuration) as client:
    api = cs2cap.PortfolioApi(client)
    response = api.update_transaction(
        portfolio_id,
        transaction_id,
        cs2cap.TransactionUpdateRequest(price=47500, currency="USD"),
    )

print(client.sanitize_for_serialization(response))

import { Configuration, PortfolioApi } from "cs2cap";

const accessToken = process.env.CS2C_API_KEY;

const portfolioId = "YOUR_PORTFOLIO_ID";
const transactionId = "YOUR_TRANSACTION_ID";

const api = new PortfolioApi(new Configuration({ accessToken }));
const response = await api.updateTransaction({
  portfolioId,
  transactionId,
  transactionUpdateRequest: { price: 47500, currency: "USD" },
});

console.log(response);

string

required

UUID of the portfolio.

string

required

UUID of the transaction to update.

integer

Updated unit count.

number

Updated price per unit.

string

Updated date in YYYY-MM-DD format.

number

Absolute fee paid, in the transaction currency.

number

Fee as a percentage of the transaction total.

string

Updated marketplace name.

string

Free-text note for this transaction.

string

Updated transaction currency (ISO 4217).

DELETE /portfolio/:id/transactions/:tx_id

Permanently deletes a transaction from the portfolio ledger. Auth: API key required

curl -sS -X DELETE \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  "https://api.cs2c.app/v1/portfolio/YOUR_PORTFOLIO_ID/transactions/YOUR_TX_ID"

import os

import cs2cap

configuration = cs2cap.Configuration(access_token=os.environ["CS2C_API_KEY"])

portfolio_id = "YOUR_PORTFOLIO_ID"
transaction_id = "YOUR_TRANSACTION_ID"

with cs2cap.ApiClient(configuration) as client:
    api = cs2cap.PortfolioApi(client)
    response = api.delete_transaction(
        portfolio_id,
        transaction_id,
    )

print(client.sanitize_for_serialization(response))

import { Configuration, PortfolioApi } from "cs2cap";

const accessToken = process.env.CS2C_API_KEY;

const portfolioId = "YOUR_PORTFOLIO_ID";
const transactionId = "YOUR_TRANSACTION_ID";

const api = new PortfolioApi(new Configuration({ accessToken }));
const response = await api.deleteTransaction({ portfolioId, transactionId });

console.log(response);

string

required

UUID of the portfolio.

string

required

UUID of the transaction to delete.

Historical valuation

GET /portfolio/:id/history

Rebuilds daily portfolio values from the transaction ledger. Returns a time series of portfolio worth over the selected date range. Auth: API key required

curl -sS \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  "https://api.cs2c.app/v1/portfolio/YOUR_PORTFOLIO_ID/history?lookback=30d&currency=USD"

import os

import cs2cap

configuration = cs2cap.Configuration(access_token=os.environ["CS2C_API_KEY"])

portfolio_id = "YOUR_PORTFOLIO_ID"

with cs2cap.ApiClient(configuration) as client:
    api = cs2cap.PortfolioApi(client)
    response = api.get_portfolio_value_history(
        portfolio_id,
        lookback="30d",
        currency="USD",
    )

print(client.sanitize_for_serialization(response))

import { Configuration, PortfolioApi } from "cs2cap";

const accessToken = process.env.CS2C_API_KEY;

const portfolioId = "YOUR_PORTFOLIO_ID";

const api = new PortfolioApi(new Configuration({ accessToken }));
const response = await api.getPortfolioValueHistory({ portfolioId, lookback: "30d", currency: "USD" });

console.log(response);

string

required

UUID of the portfolio.

string

Inclusive start date in YYYY-MM-DD format.

string

Inclusive end date in YYYY-MM-DD format. Defaults to today.

string

Optional window such as 30d. When provided, it overrides start_date.

string

default:"USD"

Target output currency (ISO 4217).

string[]

Optional provider filter. Repeat to pass multiple values.

integer

Maximum number of daily data points to return.

string

Opaque cursor from the previous page for cursor-based pagination.

Historical valuation is daily only. Each day’s value uses the best available price across your selected providers. If no price update exists for a given day, the most recent available price is used. pagination.total is always -1 — use next_cursor to paginate.

Overview

Market Data

Analytics

Portfolio

Portfolio API: Track and Value Your CS2 Items

Portfolio management

POST /portfolio

GET /portfolio

DELETE /portfolio/:id

Valuation

POST /portfolio/value

GET /portfolio/:id/value

Import and export

POST /portfolio/:id/import

POST /portfolio/:id/import/csv

GET /portfolio/:id/export

Portfolio items

GET /portfolio/:id/items

POST /portfolio/:id/items

DELETE /portfolio/:id/items/:entry_id

Transactions

GET /portfolio/:id/transactions

POST /portfolio/:id/transactions

PATCH /portfolio/:id/transactions/:tx_id

DELETE /portfolio/:id/transactions/:tx_id

Historical valuation

GET /portfolio/:id/history

​Portfolio management

​POST /portfolio

​GET /portfolio

​DELETE /portfolio/:id

​Valuation

​POST /portfolio/value

​GET /portfolio/:id/value

​Import and export

​POST /portfolio/:id/import

​POST /portfolio/:id/import/csv

​GET /portfolio/:id/export

​Portfolio items

​GET /portfolio/:id/items

​POST /portfolio/:id/items

​DELETE /portfolio/:id/items/:entry_id

​Transactions

​GET /portfolio/:id/transactions

​POST /portfolio/:id/transactions

​PATCH /portfolio/:id/transactions/:tx_id

​DELETE /portfolio/:id/transactions/:tx_id

​Historical valuation

​GET /portfolio/:id/history

Portfolio management

POST /portfolio

GET /portfolio

DELETE /portfolio/:id

Valuation

POST /portfolio/value

GET /portfolio/:id/value

Import and export

POST /portfolio/:id/import

POST /portfolio/:id/import/csv

GET /portfolio/:id/export

Portfolio items

GET /portfolio/:id/items

POST /portfolio/:id/items

DELETE /portfolio/:id/items/:entry_id

Transactions

GET /portfolio/:id/transactions

POST /portfolio/:id/transactions

PATCH /portfolio/:id/transactions/:tx_id

DELETE /portfolio/:id/transactions/:tx_id

Historical valuation

GET /portfolio/:id/history