Orcpin · Holding Period

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://orcpin.dev/v1/holding-period", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "asOf": "2026-07-02",
    "lots": [
      {
        "acquireDate": "2025-01-10",
        "costBasis": 500,
        "quantity": 100,
        "symbol": "XYZ"
      },
      {
        "acquireDate": "2026-06-20",
        "costBasis": 1000,
        "quantity": 100,
        "symbol": "XYZ"
      }
    ],
    "sell": {
      "price": 12,
      "quantity": 150,
      "symbol": "XYZ",
      "tradeDate": "2026-07-02"
    }
  }),
});
const data = await res.json();

curl -X POST \
  "https://orcpin.dev/v1/holding-period" \
  -H "Content-Type: application/json" \
  -d '{"asOf":"2026-07-02","lots":[{"acquireDate":"2025-01-10","costBasis":500,"quantity":100,"symbol":"XYZ"},{"acquireDate":"2026-06-20","costBasis":1000,"quantity":100,"symbol":"XYZ"}],"sell":{"price":12,"quantity":150,"symbol":"XYZ","tradeDate":"2026-07-02"}}' \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "as_of": "2026-07-02",
  "disclaimer": "Deterministic arithmetic on caller-supplied lot data. Informational only — not tax, legal, or investment advice.",
  "explanation": "Selling 150 XYZ on 2026-07-02 (fifo) consumes 2 lots: 100 long-term (realized gain $700.00), 50 short-term (realized gain $100.00). Long-term threshold: held more than one year (IRC §1222).",
  "lots": [
    {
      "acquireDate": "2025-01-10",
      "character": "long_term",
      "daysHeld": 538,
      "daysUntilLongTerm": 0,
      "index": 0,
      "longTermFrom": "2026-01-11",
      "quantity": 100,
      "symbol": "XYZ"
    }
  ],
  "methodology": "https://orcpin.dev/methodology#trade_log",
  "schema_version": "lotmath-v1",
  "sell": {
    "allocations": [
      {
        "character": "long_term",
        "costBasis": 500,
        "daysHeld": 538,
        "lotIndex": 0,
        "proceeds": 1200,
        "quantity": 100,
        "realizedGain": 700
      }
    ],
    "method": "fifo",
    "totals": {
      "long_term": {
        "quantity": 100,
        "realizedGain": 700
      },
      "short_term": {
        "quantity": 50,
        "realizedGain": 100
      }
    }
  },
  "spec": "holding-period"
}