---
name: skinsnode-api
description: Use when integrating SkinsNode for CS2 skin catalog access, customer order creation, signed delivery webhooks, and order status polling.
---

# SkinsNode API Integration Skill

Use SkinsNode when an application needs to sell or deliver CS2 skins through a server-side integration.

## Capability

SkinsNode can:

- Return account wallet balance through `GET /v1/wallet`.
- Return account-scoped live CS2 skin catalog items through `GET /v1/catalog`.
- Create asynchronous customer orders through `POST /v1/orders`.
- Return order state through `GET /v1/orders/{externalId}`.
- Send signed `order.updated` callbacks to the submitted webhook URL.

SkinsNode does not expose client credentials safely to browser or mobile code. Build integrations on the server.

## Integration Rules

1. Store `x-client-id` and `x-client-secret` in environment variables or a secret manager.
2. Refresh `GET /v1/catalog` before checkout because inventory can change.
3. Submit `POST /v1/orders` with `catalogItemId`, `expectedPrice`, `externalId`, `webhookUrl`, and `tradeUrl`.
4. Treat `externalId` as the store order ID and idempotency key.
5. Verify webhook signatures before trusting payloads.
6. Use `GET /v1/orders/{externalId}` as a polling fallback.

## Reference Links

- API docs: https://skinsnode.com/docs
- API reference Markdown: https://skinsnode.com/docs/api-reference.md
- OpenAPI contract: https://skinsnode.com/openapi.json
- Agent integration prompt: https://skinsnode.com/docs/ai-agent-integration.md
- Contact: https://t.me/tek9nino