Type-safe SDK
Full TypeScript client with autocomplete for every endpoint. Capture demand, run the match engine, and execute trades — all from a single import.
.buyerRequestsCapture and manage demand signals.inventoryCRUD for seller inventory items.matchPacksRun and inspect match engine results.secureTradesFull trade lifecycle management.offersNegotiate offers between parties.holdsReserve intents with deposits and expiry.liveSessionsReal-time live commerce sessions.webhooksSubscribe, manage, and test webhooks.automationsCreate rules for automatic actions.tradeGraphDemand, supply, pricing, and routing intelligenceimport { createCollectIQ } from '@collectiq/sdk';
const ciq = createCollectIQ({
apiKey: process.env.COLLECTIQ_API_KEY!,
baseUrl: 'https://app.collectiqhq.com/api/v1',
});
// Create a buyer request (demand signal)
const request = await ciq.buyerRequests.create({
cardName: 'Charizard Base Set',
setName: 'Base Set',
condition: 'near_mint',
maxPrice: 350,
});
// Run the match engine
const matches = await ciq.matchPacks.run({
buyerRequestId: request.id,
});
// Execute a trade
const trade = await ciq.secureTrades.create({
matchId: matches[0].id,
});import { verifyWebhookSignature } from '@collectiq/sdk/webhooks';
app.post('/webhooks', (req, res) => {
const event = verifyWebhookSignature(
req.body,
req.headers['x-collectiq-signature'],
process.env.COLLECTIQ_WEBHOOK_SECRET!
);
switch (event.type) {
case 'match.created':
// A new match was found
notifyBuyer(event.data.buyerRequestId);
break;
case 'trade.status_changed':
// Trade progressed (shipped, delivered, settled)
updateOrderStatus(event.data.tradeId, event.data.status);
break;
case 'trust.score_updated':
// Seller trust score changed
refreshBadge(event.data.sellerId);
break;
}
res.json({ received: true });
});Signed webhooks with replay
Every webhook delivery is HMAC-signed and tracked. Failed deliveries are automatically retried with exponential backoff. Replay any event from the Reliability Center for debugging.
- 20+ event types covering the full trade lifecycle
- HMAC-SHA256 signature verification built into the SDK
- Delivery tracking with success/failure history
- One-click replay from the portal Reliability Center
- Filter by event type, status, and date range
Embeddable widgets & badges
Drop a want-list intake form on any website with one script tag. Embed dynamic TrustGraph badges on eBay listings, forums, and social profiles — every badge links back to your verified trust profile.
<!-- Embed a want-list intake form on any site -->
<script
src="https://app.collectiqhq.com/widget.js"
data-seller="your-slug"
data-theme="dark"
async
></script>
<!-- Or embed a trust badge -->
<img
src="https://collectiqhq.com/api/embed/trust-badge/your-slug"
alt="CollectIQ Verified"
height="48"
/>Starter kits
Clone, configure, deploy. Production-ready templates for common integration patterns.
Trade App Starter
Full-stack Next.js app with SDK integration, auth, and trade UI.
Seller Dashboard
React + Vite dashboard for inventory management and trade monitoring.
Webhook Consumer
Production-ready Express server for processing CollectIQ webhook events.
TradeGraph Intelligence API
Real-time market intelligence for collectibles. Demand clusters, supply health, pricing anomalies, and optimal execution routing — all with full explainability so you can show why every recommendation was made.
/tradegraph/summaryDemand clusters, velocity, trends, missed-demand/tradegraph/supplyFreshness, stale capital, saturation, sell-through/tradegraph/pricingPrice bands, anomaly detection, dispersion scoring/tradegraph/routingBest execution actions with EV and confidence// Fetch real-time pricing intelligence
const pricing = await ciq.tradeGraph.pricing({
windowDays: 30,
});
// Anomaly detection
pricing.anomalies.forEach((a) => {
console.log(a.itemName, a.direction, a.severity);
// "Charizard Base Set" "above" "high"
});
// Get best-execution routing
const routing = await ciq.tradeGraph.routing();
routing.actions
.filter((a) => a.confidence > 0.7)
.forEach((a) => {
console.log(a.type, a.itemName, a.ev_cents);
// "notify_now" "PSA 10 Pikachu" 4500
});