Orcpin

Trade-lot holding-period and realized-gain calculator for trading agents: per-lot days held, the exact date each lot's gain character turns long-term, and FIFO / specific-identification allocation of a proposed sell with realized gain per lot and per-character totals. Deterministic arithmetic on caller-supplied lots with the published threshold cited (IRC §1222: held more than one year) — counts, dates, and dollars only, never advice. Nothing is stored.

SearchLiveeip155:8453Exactvia cdp
Orcpin Trade LogTradingEquitiesTax-lotsHolding-period
Calls · 30d
1→ 0%
This endpoint's own trailing-30-day call count, as published by the upstream catalog and snapshotted daily. 24 snapshots so far.
$158.61
Verified settled volume
137 settlements proven x402 by their on-chain EIP-3009 marker.
$0.020
Listed price
As published in the catalog. Always read the live 402 before paying.
1
Calls · 30d
Upstream's own call count for this endpoint, not ours.
1
Unique payers · 30d
Last called 2026-08-17 19:38Z
Upstream on-chain volume
Reported by the source catalog.
Paid to
0x8B1CF12e7efe6AEA59cD1124eBbe7709E3Ac6085

The wallet the 402 directs payment to. Its whole payment record — every payer, every chain — is on the merchant page.

Asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Provider

The payTo wallet does not resolve to a registered ERC-8004 agent. That is not a verdict on the service — most of the catalog is unregistered.

Live 402 challenge

Captured by the enrichment pass, not read just now. Prices can change — always read the 402 the endpoint answers with.

{
  "docs": {
    "catalog": "https://orcpin.dev/catalog",
    "openapi": "https://orcpin.dev/openapi.json",
    "methodology": "https://orcpin.dev/methodology"
  },
  "error": "Payment required",
  "accepts": [
    {
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "extra": {
        "name": "USD Coin",
        "version": "2"
      },
      "payTo": "0x8B1CF12e7efe6AEA59cD1124eBbe7709E3Ac6085",
      "amount": "20000",
      "scheme": "exact",
      "network": "eip155:8453",
      "maxTimeoutSeconds": 300
    }
  ],
  "message": "GET is not supported on /v1/holding-period; this resource is payable over x402 via POST. The price and input schema below are the ones POST /v1/holding-period will charge and expect.",
  "resource": {
    "url": "https://orcpin.dev/v1/holding-period",
    "tags": [
      "Orcpin Trade Log",
      "trading",
      "equities",
      "tax-lots",
      "holding-period"
    ],
    "iconUrl": "https://orcpin.com/orcpin-logo.png",
    "mimeType": "application/json",
    "description": "Trade-lot holding-period and realized-gain calculator for trading agents: per-lot days held, the exact date each lot's gain character turns long-term, and FIFO / specific-identification allocation of a proposed sell with realized gain per lot and per-character totals. Deterministic arithmetic on caller-supplied lots with the published threshold cited (IRC §1222: held more than one year) — counts, dates, and dollars only, never advice. Nothing is stored.",
    "serviceName": "Orcpin"
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "body": {
            "asOf": "2026-07-02",
            "lots": [
              {
                "symbol": "XYZ",
                "quantity": 100,
                "costBasis": 500,
                "acquireDate": "2025-01-10"
              },
              {
                "symbol": "XYZ",
                "quantity": 100,
                "costBasis": 1000,
                "acquireDate": "2026-06-20"
              }
            ],
            "sell": {
              "price": 12,
              "symbol": "XYZ",
              "quantity": 150,
              "tradeDate": "2026-07-02"
            }
          },
          "type": "http",
          "bodyType": "json"
        },
        "output": {
          "type": "json",
          "example": {
            "lots": [
              {
                "index": 0,
                "symbol": "XYZ",
                "daysHeld": 538,
                "quantity": 100,
                "character": "long_term",
                "acquireDate": "2025-01-10",
                "longTermFrom": "2026-01-11",
                "daysUntilLongTerm": 0
              }
            ],
            "sell": {
              "method": "fifo",
              "totals": {
                "long_term": {
                  "quantity": 100,
                  "realizedGain": 700
                },
                "short_term": {
                  "quantity": 50,
                  "realizedGain": 100
                }
              },
              "allocations": [
                {
                  "daysHeld": 538,
                  "lotIndex": 0,
                  "proceeds": 1200,
                  "quantity": 100,
                  "character": "long_term",
                  "costBasis": 500,
                  "realizedGain": 700
                }
              ]
            },
            "spec": "holding-period",
            "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).",
            "methodology": "https://orcpin.dev/methodology#trade_log",
            "schema_version": "lotmath-v1"
          }
        }
      },
      "schema": {
        "type": "object",
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "required": [
          "input"
        ],
        "properties": {
          "input": {
            "type": "object",
            "required": [
              "type",
              "method",
              "bodyType",
              "body"
            ],
            "properties": {
              "body": {
                "type": "object",
                "required": [
                  "asOf",
                  "lots"
                ],
                "properties": {
                  "asOf": {
                    "type": "string",
                    "description": "Evaluation date, YYYY-MM-DD (UTC calendar days; no server clock is used)."
                  },
                  "lots": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "symbol",
                        "acquireDate",
                        "quantity"
                      ],
                      "properties": {
                        "symbol": {
                          "type": "string"
                        },
                        "account": {
                          "type": "string"
                        },
                        "quantity": {
                          "type": "number"
                        },
                        "costBasis": {
                          "type": "number"
                        },
                        "acquireDate": {
                          "type": "string",
                          "description": "YYYY-MM-DD"
                        }
                      }
                    },
                    "description": "Tax lots to evaluate. costBasis (total USD for the lot) is optional — absent means gain math is omitted for that lot."
                  },
                  "sell": {
                    "type": "object",
                    "required": [
                      "symbol",
                      "tradeDate",
                      "quantity"
                    ],
                    "properties": {
                      "price": {
                        "type": "number"
                      },
                      "method": {
                        "enum": [
                          "fifo",
                          "as_supplied"
                        ],
                        "type": "string"
                      },
                      "symbol": {
                        "type": "string"
                      },
                      "quantity": {
                        "type": "number"
                      },
                      "tradeDate": {
                        "type": "string",
                        "description": "YYYY-MM-DD"
                      }
                    },
                    "description": "Optional proposed sell to allocate across the lots (FIFO or as_supplied). price (per share USD) optional."
                  }
                }
              },
              "type": {
                "type": "string",
                "const": "http"
              },
              "method": {
                "enum": [
                  "POST",
                  "PUT",
                  "PATCH"
                ],
                "type": "string"
              },
              "bodyType": {
                "enum": [
                  "json",
                  "form-data",
                  "text"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "output": {
            "type": "object",
            "required": [
              "type"
            ],
            "properties": {
              "type": {
                "type": "string"
              },
              "example": {
                "type": "object",
                "properties": {
                  "lots": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    }
                  },
                  "sell": {
                    "type": [
                      "object",
                      "null"
                    ]
                  },
                  "as_of": {
                    "type": "string"
                  },
                  "disclaimer": {
                    "type": "string"
                  },
                  "explanation": {
                    "type": "string"
                  },
                  "schema_version": {
                    "type": "string"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "retry_with": {
    "url": "https://orcpin.dev/v1/holding-period",
    "body": {
      "asOf": "2026-07-02",
      "lots": [
        {
          "symbol": "XYZ",
          "quantity": 100,
          "costBasis": 500,
          "acquireDate": "2025-01-10"
        },
        {
          "symbol": "XYZ",
          "quantity": 100,
          "costBasis": 1000,
          "acquireDate": "2026-06-20"
        }
      ],
      "sell": {
        "price": 12,
        "symbol": "XYZ",
        "quantity": 150,
        "tradeDate": "2026-07-02"
      }
    },
    "method": "POST",
    "content_type": "application/json"
  },
  "x402Version": 2,
  "method_required": "POST"
}

Accepts

The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.

0.02USDC≈ $0.02 USD
on Base · exact scheme

Pay 0.02 USDC on Base to 0x8B1C…c6085. The signed payment is good for 5 minutes.

USD Coin contract
0x8335…02913
Payment window
5 minutes
As published
20000 smallest units
The catalog’s raw entry
[
  {
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "extra": {
      "name": "USD Coin",
      "version": "2"
    },
    "payTo": "0x8B1CF12e7efe6AEA59cD1124eBbe7709E3Ac6085",
    "amount": "20000",
    "scheme": "exact",
    "network": "eip155:8453",
    "maxTimeoutSeconds": 300
  }
]

Extensions

{
  "bazaar": {
    "info": {
      "input": {
        "body": {
          "asOf": "2026-07-02",
          "lots": [
            {
              "symbol": "XYZ",
              "quantity": 100,
              "costBasis": 500,
              "acquireDate": "2025-01-10"
            },
            {
              "symbol": "XYZ",
              "quantity": 100,
              "costBasis": 1000,
              "acquireDate": "2026-06-20"
            }
          ],
          "sell": {
            "price": 12,
            "symbol": "XYZ",
            "quantity": 150,
            "tradeDate": "2026-07-02"
          }
        },
        "type": "http",
        "method": "POST",
        "bodyType": "json"
      },
      "output": {
        "type": "json",
        "example": {
          "lots": [
            {
              "index": 0,
              "symbol": "XYZ",
              "daysHeld": 538,
              "quantity": 100,
              "character": "long_term",
              "acquireDate": "2025-01-10",
              "longTermFrom": "2026-01-11",
              "daysUntilLongTerm": 0
            }
          ],
          "sell": {
            "method": "fifo",
            "totals": {
              "long_term": {
                "quantity": 100,
                "realizedGain": 700
              },
              "short_term": {
                "quantity": 50,
                "realizedGain": 100
              }
            },
            "allocations": [
              {
                "daysHeld": 538,
                "lotIndex": 0,
                "proceeds": 1200,
                "quantity": 100,
                "character": "long_term",
                "costBasis": 500,
                "realizedGain": 700
              }
            ]
          },
          "spec": "holding-period",
          "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).",
          "methodology": "https://orcpin.dev/methodology#trade_log",
          "schema_version": "lotmath-v1"
        }
      }
    },
    "schema": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "input"
      ],
      "properties": {
        "input": {
          "type": "object",
          "required": [
            "type",
            "method",
            "bodyType",
            "body"
          ],
          "properties": {
            "body": {
              "type": "object",
              "required": [
                "asOf",
                "lots"
              ],
              "properties": {
                "asOf": {
                  "type": "string",
                  "description": "Evaluation date, YYYY-MM-DD (UTC calendar days; no server clock is used)."
                },
                "lots": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "required": [
                      "symbol",
                      "acquireDate",
                      "quantity"
                    ],
                    "properties": {
                      "symbol": {
                        "type": "string"
                      },
                      "account": {
                        "type": "string"
                      },
                      "quantity": {
                        "type": "number"
                      },
                      "costBasis": {
                        "type": "number"
                      },
                      "acquireDate": {
                        "type": "string",
                        "description": "YYYY-MM-DD"
                      }
                    }
                  },
                  "description": "Tax lots to evaluate. costBasis (total USD for the lot) is optional — absent means gain math is omitted for that lot."
                },
                "sell": {
                  "type": "object",
                  "required": [
                    "symbol",
                    "tradeDate",
                    "quantity"
                  ],
                  "properties": {
                    "price": {
                      "type": "number"
                    },
                    "method": {
                      "enum": [
                        "fifo",
                        "as_supplied"
                      ],
                      "type": "string"
                    },
                    "symbol": {
                      "type": "string"
                    },
                    "quantity": {
                      "type": "number"
                    },
                    "tradeDate": {
                      "type": "string",
                      "description": "YYYY-MM-DD"
                    }
                  },
                  "description": "Optional proposed sell to allocate across the lots (FIFO or as_supplied). price (per share USD) optional."
                }
              }
            },
            "type": {
              "type": "string",
              "const": "http"
            },
            "method": {
              "enum": [
                "POST"
              ],
              "type": "string"
            },
            "bodyType": {
              "enum": [
                "json",
                "form-data",
                "text"
              ],
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        "output": {
          "type": "object",
          "required": [
            "type"
          ],
          "properties": {
            "type": {
              "type": "string"
            },
            "example": {
              "type": "object",
              "properties": {
                "lots": {
                  "type": "array",
                  "items": {
                    "type": "object"
                  }
                },
                "sell": {
                  "type": [
                    "object",
                    "null"
                  ]
                },
                "as_of": {
                  "type": "string"
                },
                "disclaimer": {
                  "type": "string"
                },
                "explanation": {
                  "type": "string"
                },
                "schema_version": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  }
}

Provenance

Seen in the source catalog
2026-08-17 19:38Z
Last indexed by Roundhouse
2026-09-16 19:40Z
Last enriched (probe, favicon, geo)
2026-09-14 01:15Z
x402 version
2
Max timeout
300s
Liveness probe
HTTP 402
Report

Hand this page to an agent

Copy the prompt and paste it into Claude, an MCP client or your own agent — it will vet this service and call it over the free read API. No key, no account.

GET api.roundhouseai.io/v0/endpoints

This endpoint's own trailing-30-day call count, as published by the upstream catalog and snapshotted daily. 24 snapshots so far. Verified volume counts only settlements with an on-chain EIP-3009 marker.

Open skill.md
Show the prompt
Using Roundhouse, look up the x402 service Orcpin and tell me whether it is
worth paying: what a call costs, whether the endpoint answered when last probed, and what
its payment record actually shows.

curl -s 'https://api.roundhouseai.io/v0/endpoints?q=Orcpin'
curl -s 'https://api.roundhouseai.io/v0/merchants/<the payTo wallet returned above>'

Then call it: read the price from the live 402 at https://orcpin.dev/v1/holding-period, never from
a cached figure, and pay with an x402 client.

The /v0 API needs an API key (`authorization: Bearer rh_live_…`) on everything except
/v0/unified* and /v0/endpoints. Mint a personal key for $0.01 at GET https://api.roundhouseai.io/v0/test/x402,
or use an organization key from https://roundhouseai.io/dashboard/team.

If you do not have Roundhouse tools or skills installed, read
https://roundhouseai.io/skill.md first — it is the whole procedure.