cardtrader-api_skill

Overview

This skill integrates with the CardTrader REST API to manage trading card marketplace operations, inventory, orders, carts, and wishlists. It centralizes authentication, marketplace searches, product and batch inventory operations, order lifecycle actions, and webhook handling for automation. Use it to build reliable marketplace integrations and automate fulfillment workflows.

How this skill works

The skill issues authenticated HTTP requests to CardTrader's API endpoints (base URL: https://api.cardtrader.com/api/v2) using a Bearer token. It supports single and asynchronous batch product operations, marketplace searches, cart and purchase flows, order updates (tracking/ship/cancel), wishlist endpoints, CSV import/export, and job status polling for long-running tasks. It also verifies webhooks via HMAC-SHA256 signatures and handles common API errors and rate limits.

When to use it

• Sync your inventory with CardTrader (single or bulk) and keep stock/price consistent.
• Automate order fulfillment: poll orders, set tracking codes, and mark shipments.
• Build a marketplace integration to search products, compare prices, and purchase.
• Import/export large product catalogs via CSV or async batch jobs.
• Maintain wishlists, CT0 box items, and webhook-driven notifications.

Best practices

• Use batch endpoints for large updates and poll /jobs/{uuid} to confirm completion.
• Respect rate limits (200/10s general; marketplace 10/s; jobs 1/s) and implement exponential backoff.
• Set long timeouts for /products/export (120–180s) and for bulk import operations.
• Use error_mode: "strict" during development to catch invalid product properties early.
• Store internal IDs in user_data_field to simplify reconciliation between systems.
• Cache static reference data (games, expansions, blueprints, properties) and refresh periodically.

Example use cases

• Periodic inventory sync: export CardTrader products, diff with local DB, and bulk_update/create/destroy changes.
• Order processing pipeline: poll paid orders, decrement local stock, put tracking code, and ship.
• Price monitoring tool: fetch marketplace products by blueprint_id and select the lowest-priced listing.
• Bulk CSV import of a new warehouse stock using product_imports and checking skipped rows.
• Automated marketplace purchasing: add product to cart, verify cart, and POST /cart/purchase.