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.
The wallet the 402 directs payment to. Its whole payment record — every payer, every chain — is on the merchant page.
Asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
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.
Pay 0.02 USDC on Base to 0x8B1C…c6085. The signed payment is good for 5 minutes.
- Paid to
- 0x8B1C…c6085
- 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
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.
Show the promptHide 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.