{"api":"v1","generated_at":"2026-09-15T23:50:37.650Z","licence":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/","attribution":"TOLL, with a link to the page cited"},"page":"https://tollindex.com/e/orcpin-dev-v1-holding-period-5a2fa0","pinned_page":"https://tollindex.com/e/orcpin-dev-v1-holding-period-5a2fa0/at/2026-09-15T21-20Z","pinned":false,"method":"https://tollindex.com/ledger/method","snapshot_at":"2026-09-15T21:20:12.737Z","snapshot_stamp":"2026-09-15T21-20Z","endpoint":{"slug":"orcpin-dev-v1-holding-period-5a2fa0","canonical_url":"https://orcpin.dev/v1/holding-period","resource":"https://orcpin.dev/v1/holding-period","http_method":"POST","type":"http","x402_version":2,"registries":["cdp"],"primary_registry":"cdp","curated_by_coinbase":false,"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.","service_name":"Orcpin","declared_category":null,"declared_tags":["Orcpin Trade Log","trading","equities","tax-lots","holding-period"],"route_template":null,"registry_updated":"2026-08-17T19:38:37.571Z"},"derived":{"note":"fields no registry supplies; TOLL derives them and marks them derived on the page","title":"holding period","category":"market-data","first_observed_by_toll":"2026-09-10T19:08:24.178Z","last_observed_by_toll":"2026-09-15T21:20:12.737Z","observation_began":"2026-09-10"},"presence":{"listed_now":true,"first_absent_at":null,"delisting_confirmed_at":null,"events":[{"registry":"cdp","at":"2026-09-10T19:08:24.178Z","event":"listed"}]},"accepts":[{"registry":"cdp","ordinal":0,"network":"eip155:8453","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","asset_name":"USD Coin","symbol":"USDC","decimals":6,"amount_display":"0.02 USDC","amount_units":0.02,"decimals_known":true,"pay_to":"0x8B1CF12e7efe6AEA59cD1124eBbe7709E3Ac6085","scheme":"exact"}],"counters":{"observed_at":"2026-09-15T21:20:12.737Z","calls_30d":1,"unique_payers_30d":1,"last_called_at":"2026-08-17T19:38:37.336Z"},"validation":{"latest":{"observed_at":"2026-09-15T04:50:27.742Z","state":"pass","failed_checks":[],"endpoint_http_status":402,"run_id":"daily-2026-09-15"},"uptime":[{"days":7,"observed":5,"passed":5,"ratio":1},{"days":30,"observed":5,"passed":5,"ratio":1},{"days":90,"observed":5,"passed":5,"ratio":1}],"history_90d":[{"observed_at":"2026-09-15T04:50:27.742Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-15","state_changed":false},{"observed_at":"2026-09-14T04:45:50.416Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-14","state_changed":false},{"observed_at":"2026-09-13T04:43:20.867Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-13","state_changed":false},{"observed_at":"2026-09-12T07:00:14.546Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-12","state_changed":false},{"observed_at":"2026-09-11T10:37:21.362Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-11","state_changed":true}]},"seller":{"wallet":"0x8B1CF12e7efe6AEA59cD1124eBbe7709E3Ac6085","page":"https://tollindex.com/seller/0x8B1CF12e7efe6AEA59cD1124eBbe7709E3Ac6085","endpoints":9,"hosts":1},"reports":0,"registry_record":{"cdp":[{"tags":["Orcpin Trade Log","trading","equities","tax-lots","holding-period"],"type":"http","accepts":[{"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","extra":{"name":"USD Coin","version":"2"},"payTo":"0x8B1CF12e7efe6AEA59cD1124eBbe7709E3Ac6085","amount":"20000","scheme":"exact","network":"eip155:8453","maxTimeoutSeconds":300}],"iconUrl":"https://res.cloudinary.com/bdb-prod/image/upload/c_fill,ar_1:1,w_256,h_256,f_auto,q_auto/v1781813595/bazaar-icons/403887c2832039d8.png","quality":{"lastCalledAt":"2026-08-17T19:38:37.336Z","l30DaysTotalCalls":1,"l30DaysUniquePayers":1},"resource":"https://orcpin.dev/v1/holding-period","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"}}}}}}}}},"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.","lastUpdated":"2026-08-17T19:38:37.571Z","serviceName":"Orcpin","x402Version":2}]}}