# Send BitSkins to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "bitskins",
    "name": "BitSkins",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/bluesyparty-src/bitskins",
    "canonicalUrl": "https://clawhub.ai/bluesyparty-src/bitskins",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/bitskins",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=bitskins",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/bitskins-api.sh",
      "references/websocket.md",
      "references/api-endpoints.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "bitskins",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T13:40:09.748Z",
      "expiresAt": "2026-05-07T13:40:09.748Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=bitskins",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=bitskins",
        "contentDisposition": "attachment; filename=\"bitskins-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "bitskins"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/bitskins"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/bitskins",
    "downloadUrl": "https://openagent3.xyz/downloads/bitskins",
    "agentUrl": "https://openagent3.xyz/skills/bitskins/agent",
    "manifestUrl": "https://openagent3.xyz/skills/bitskins/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/bitskins/agent.md"
  }
}
```
## Documentation

### Authentication

All requests to the BitSkins API require authentication via the x-apikey header.

The API key must be set in the environment variable BITSKINS_API_KEY.
The user can obtain their API key from BitSkins account settings after enabling API access.

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.

### Base URL

https://api.bitskins.com

### Making Requests

Use the helper script to make API calls:

bash bitskins-api/scripts/bitskins-api.sh <METHOD> <PATH> [JSON_BODY]

Examples:

# GET request (no body)
bash bitskins-api/scripts/bitskins-api.sh GET /account/profile/me

# POST request with JSON body
bash bitskins-api/scripts/bitskins-api.sh POST /account/profile/balance

# POST with parameters
bash bitskins-api/scripts/bitskins-api.sh POST /market/search/730 '{"limit":10,"offset":0,"where":{}}'

### Rate Limits

Global: 50 requests per 10 seconds
Market search (/market/search/*): 1 request per second
These limits are dynamic and may be reduced under heavy server load.

### Request Format

The API accepts JSON format
GET requests: no body required
POST requests: JSON body with required parameters

### Response Format

All responses are JSON. Successful responses contain the data directly. Error responses include error codes documented in references/api-endpoints.md.

### API Sections Overview

The API is organized into the following sections. See references/api-endpoints.md for the full endpoint reference.

### Account

Profile: Get session info, balance, update account settings, update trade link, block account
Affiliate: Get affiliate info, claim money, view reward history, set affiliate code
2FA: Create, verify, disable, lock/unlock two-factor authentication
API Access: Create or disable API keys

### Config

Currency rates: Get current exchange rates
Fee plans: Get available fee plans
Platform status: Check if platform is operational

### Market (CS2 app_id=730, Dota 2 app_id=570)

Pricing: Get sales history, pricing summaries
Search: Browse CS2/Dota 2 markets, search own items, get item details, search by skin name, get filters
Buy: Buy single item, multiple items, or bulk buy
Withdraw: Withdraw single or multiple purchased items to Steam
Delist: Remove single or multiple items from sale
Relist: Relist single or multiple delisted items
Update price: Change price on single or multiple listed items
History: View item transaction history
Receipt: Get purchase receipt
Bump: Bump items for visibility, manage bump settings, buy bump packages
Skins catalog: Get all available skin names for a game
In-sell items: Get all currently listed items for a game

### Steam

Inventory: List Steam inventory items
Deposit: Deposit items from Steam to BitSkins
Trades: View Steam trade offers and their status

### Wallet

Stats: Get wallet statistics, KYC limits
Transactions: List completed and pending transactions
Reports: Generate and download wallet reports

### Wallet Deposit

Binance Pay: Create Binance Pay deposit
Cryptocurrency: Get deposit addresses for BTC, LTC, ETH
Gift codes: Redeem gift codes, view used codes
Zen: Create Zen deposit
Card (Unlimint): Add cards, list cards, deposit via card

### Wallet Withdraw

Cryptocurrency: Withdraw to BTC, LTC, ETH addresses
Binance Pay: Withdraw via Binance Pay
Card (Unlimint): Withdraw to Visa card

### WebSocket

Real-time updates via wss://ws.bitskins.com. See references/websocket.md for details.

### Searching the Market

The market search endpoints accept where objects for filtering and support limit/offset pagination:

{
  "limit": 20,
  "offset": 0,
  "order": [{"field": "price", "order": "ASC"}],
  "where": {
    "skin_name": ["AK-47 | Redline"],
    "price_from": 1000,
    "price_to": 5000
  }
}

Note: Prices are in cents (e.g., 1000 = $10.00).

### Buying Items

To buy an item, you need its id and app_id. Use market search to find items, then:

{"app_id": 730, "id": "ITEM_ID", "max_price": 1500}

The max_price parameter protects against price changes between search and purchase.

### Listing/Depositing Items

Get Steam inventory: POST /steam/inventory/list
Deposit items: POST /steam/deposit/many with item IDs and prices
Monitor trade status: POST /steam/trade/active

### Withdrawing Purchased Items

After buying, withdraw to Steam:

{"app_id": 730, "id": "ITEM_ID"}

### Important Notes

Always confirm with the user before executing buy, sell, withdraw, or any financial operation
Prices are in cents (integer values)
Game IDs: CS2 = 730, Dota 2 = 570
The where_mine filter on "mine" endpoints accepts: listed, pending_withdrawal, in_queue, given, need_to_withdraw
2FA codes are time-sensitive; always request fresh codes from the user
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: bluesyparty-src
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T13:40:09.748Z
- Expires at: 2026-05-07T13:40:09.748Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/bitskins)
- [Send to Agent page](https://openagent3.xyz/skills/bitskins/agent)
- [JSON manifest](https://openagent3.xyz/skills/bitskins/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/bitskins/agent.md)
- [Download page](https://openagent3.xyz/downloads/bitskins)