{"skill":{"slug":"bitskins","displayName":"BitSkins","summary":"Interacts with the BitSkins REST API V2 and WebSocket API for CS2/Dota 2 skin trading. Supports account management, market search, buying, selling, listing, delisting, relisting, price updates, Steam inventory/deposits/trades, wallet operations, and real-time WebSocket subscriptions. Use when the user wants to search for skins, check prices, buy or sell items, manage their BitSkins account, check balances, or interact with the BitSkins marketplace.","description":"---\nname: bitskins-api\ndescription: >\n  Interacts with the BitSkins REST API V2 and WebSocket API for CS2/Dota 2 skin trading.\n  Supports account management, market search, buying, selling, listing, delisting, relisting,\n  price updates, Steam inventory/deposits/trades, wallet operations, and real-time WebSocket\n  subscriptions. Use when the user wants to search for skins, check prices, buy or sell items,\n  manage their BitSkins account, check balances, or interact with the BitSkins marketplace.\nmetadata:\n  author: custom\n  version: \"1.0\"\n  env_vars: \"BITSKINS_API_KEY\"\n---\n\n# BitSkins API Skill\n\n## Authentication\n\nAll requests to the BitSkins API require authentication via the `x-apikey` header.\n\nThe API key must be set in the environment variable `BITSKINS_API_KEY`.\nThe user can obtain their API key from BitSkins account settings after enabling API access.\n\n**Important:** Some endpoints (wallet withdrawals, 2FA operations) also require a `twofa_code` parameter. Always ask the user for their 2FA code when calling these endpoints rather than storing it.\n\n## Base URL\n\n```\nhttps://api.bitskins.com\n```\n\n## Making Requests\n\nUse the helper script to make API calls:\n\n```bash\nbash bitskins-api/scripts/bitskins-api.sh <METHOD> <PATH> [JSON_BODY]\n```\n\nExamples:\n\n```bash\n# GET request (no body)\nbash bitskins-api/scripts/bitskins-api.sh GET /account/profile/me\n\n# POST request with JSON body\nbash bitskins-api/scripts/bitskins-api.sh POST /account/profile/balance\n\n# POST with parameters\nbash bitskins-api/scripts/bitskins-api.sh POST /market/search/730 '{\"limit\":10,\"offset\":0,\"where\":{}}'\n```\n\n## Rate Limits\n\n- **Global:** 50 requests per 10 seconds\n- **Market search (`/market/search/*`):** 1 request per second\n- These limits are dynamic and may be reduced under heavy server load.\n\n## Request Format\n\n- The API accepts JSON format\n- GET requests: no body required\n- POST requests: JSON body with required parameters\n\n## Response Format\n\nAll responses are JSON. Successful responses contain the data directly. Error responses include error codes documented in [references/api-endpoints.md](references/api-endpoints.md).\n\n## API Sections Overview\n\nThe API is organized into the following sections. See [references/api-endpoints.md](references/api-endpoints.md) for the full endpoint reference.\n\n### Account\n- **Profile:** Get session info, balance, update account settings, update trade link, block account\n- **Affiliate:** Get affiliate info, claim money, view reward history, set affiliate code\n- **2FA:** Create, verify, disable, lock/unlock two-factor authentication\n- **API Access:** Create or disable API keys\n\n### Config\n- **Currency rates:** Get current exchange rates\n- **Fee plans:** Get available fee plans\n- **Platform status:** Check if platform is operational\n\n### Market (CS2 app_id=730, Dota 2 app_id=570)\n- **Pricing:** Get sales history, pricing summaries\n- **Search:** Browse CS2/Dota 2 markets, search own items, get item details, search by skin name, get filters\n- **Buy:** Buy single item, multiple items, or bulk buy\n- **Withdraw:** Withdraw single or multiple purchased items to Steam\n- **Delist:** Remove single or multiple items from sale\n- **Relist:** Relist single or multiple delisted items\n- **Update price:** Change price on single or multiple listed items\n- **History:** View item transaction history\n- **Receipt:** Get purchase receipt\n- **Bump:** Bump items for visibility, manage bump settings, buy bump packages\n- **Skins catalog:** Get all available skin names for a game\n- **In-sell items:** Get all currently listed items for a game\n\n### Steam\n- **Inventory:** List Steam inventory items\n- **Deposit:** Deposit items from Steam to BitSkins\n- **Trades:** View Steam trade offers and their status\n\n### Wallet\n- **Stats:** Get wallet statistics, KYC limits\n- **Transactions:** List completed and pending transactions\n- **Reports:** Generate and download wallet reports\n\n### Wallet Deposit\n- **Binance Pay:** Create Binance Pay deposit\n- **Cryptocurrency:** Get deposit addresses for BTC, LTC, ETH\n- **Gift codes:** Redeem gift codes, view used codes\n- **Zen:** Create Zen deposit\n- **Card (Unlimint):** Add cards, list cards, deposit via card\n\n### Wallet Withdraw\n- **Cryptocurrency:** Withdraw to BTC, LTC, ETH addresses\n- **Binance Pay:** Withdraw via Binance Pay\n- **Card (Unlimint):** Withdraw to Visa card\n\n### WebSocket\nReal-time updates via `wss://ws.bitskins.com`. See [references/websocket.md](references/websocket.md) for details.\n\n## Common Patterns\n\n### Searching the Market\n\nThe market search endpoints accept `where` objects for filtering and support `limit`/`offset` pagination:\n\n```json\n{\n  \"limit\": 20,\n  \"offset\": 0,\n  \"order\": [{\"field\": \"price\", \"order\": \"ASC\"}],\n  \"where\": {\n    \"skin_name\": [\"AK-47 | Redline\"],\n    \"price_from\": 1000,\n    \"price_to\": 5000\n  }\n}\n```\n\nNote: Prices are in **cents** (e.g., 1000 = $10.00).\n\n### Buying Items\n\nTo buy an item, you need its `id` and `app_id`. Use market search to find items, then:\n\n```json\n{\"app_id\": 730, \"id\": \"ITEM_ID\", \"max_price\": 1500}\n```\n\nThe `max_price` parameter protects against price changes between search and purchase.\n\n### Listing/Depositing Items\n\n1. Get Steam inventory: `POST /steam/inventory/list`\n2. Deposit items: `POST /steam/deposit/many` with item IDs and prices\n3. Monitor trade status: `POST /steam/trade/active`\n\n### Withdrawing Purchased Items\n\nAfter buying, withdraw to Steam:\n```json\n{\"app_id\": 730, \"id\": \"ITEM_ID\"}\n```\n\n## Important Notes\n\n- Always confirm with the user before executing buy, sell, withdraw, or any financial operation\n- Prices are in cents (integer values)\n- Game IDs: CS2 = 730, Dota 2 = 570\n- The `where_mine` filter on \"mine\" endpoints accepts: `listed`, `pending_withdrawal`, `in_queue`, `given`, `need_to_withdraw`\n- 2FA codes are time-sensitive; always request fresh codes from the user\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":1480,"installsAllTime":56,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1770566674755,"updatedAt":1779076781636},"latestVersion":{"version":"1.0.0","createdAt":1770566674755,"changelog":"Initial release of BitSkins API skill.\n\n- Enables interaction with BitSkins REST and WebSocket APIs for CS2/Dota 2 skin trading.\n- Supports user authentication, account management, searching the market, buying/selling items, and managing deposits/withdrawals.\n- Includes wallet operations, KYC, transaction history, and reports.\n- Provides Steam inventory integration and real-time marketplace updates via WebSocket.\n- Requires a BitSkins API key (via environment variable) and 2FA codes for sensitive actions.\n- Includes clear examples and guidelines for using each core API endpoint.","license":null},"metadata":null,"owner":{"handle":"bluesyparty-src","userId":"s172t0teprpm3p4fz6cnfeb7es884w6s","displayName":"bluesyparty-src","image":"https://avatars.githubusercontent.com/u/258582047?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1779961033945}}