Core API

// One item
await api(`/market/transactions/${tradeRef}/items/${itemRef}/cancel`, { method: "POST" });
// Everything still cancellable on the trade
await api(`/market/transactions/${tradeRef}/cancel`, { method: "POST" });

items: [{ listingId, maxPrice, externalId: "order-42-item-1" }]
// quick buy: one ref per unit, in order
{ itemId, maxPrice, amount: 3, delivery: "standard",
  externalIds: ["order-42-a", "order-42-b", "order-42-c"] }

import { randomUUID } from "node:crypto";

async function checkoutOnSkinShark(input: {
  checkoutId: string;       // your order ID
  listingId: string;
  maxPrice: string;         // decimal string
}) {
  // Buy as the merchant (no On-Behalf-Of)
  return api<{ id: string; status: string; totalPrice: number }>(
    "/market/buy",
    {
      method: "POST",
      body: JSON.stringify({
        items: [
          {
            listingId: input.listingId,
            maxPrice: input.maxPrice,
            externalId: `${input.checkoutId}-1`,
          },
        ],
        externalId: input.checkoutId,
      }),
    },
  );
}

async function reconcileLastDay() {
  const since = new Date(Date.now() - 24 * 60 * 60 * 1000).toISOString();
  const stats = await api<{
    totals: { gmv: number; feesEarned: number; tradeCount: number };
  }>(`/merchant/stats?from=${encodeURIComponent(since)}`);
  return stats.totals;
}