{"openapi":"3.1.0","info":{"title":"Equity Analytics API","version":"1.0.0","description":"Financial ratios, two-stage DCF, WACC, OLS beta, corporate-action adjustments, total-return indexes, Altman/Piotroski/Beneish screens, DuPont and peer multiples, dividend metrics, and ISIN/CUSIP/SEDOL/LEI check-digit validation from caller-supplied statements and prices. Paid with x402 exact USDC on Base. No account is required.","contact":{"email":"support@brainiac.software"},"x-guidance":"BRAINIAC.software is a pay-per-call API for software agents. No account or API key is required.\nPayment uses x402 with exact USDC on Base (8453). Each paid resource accepts POST for the call; unpaid GET/HEAD return the same 402 payment challenge for discovery.\nHow to call an operation:\n1. POST JSON matching the requestBody. An unpaid POST (including empty body) returns 402 payment terms before body validation.\n2. Compare 402 payTo, asset, and network with /api/v1/catalog and /.well-known/x402 — not only with the 402 itself.\n3. Pay and retry with payment-signature. Invalid JSON/schema after payment-signature returns 400 and is not charged. Settlement (a charge) only on 2xx. payment-signature attached ≠ charged.\nIdempotency-Key: 64 hex chars from 32 random bytes. Reuse only for the same operation and body (replays stored response, including status=partial). A new key runs a fresh call.\nIdempotency after errors: unpaid 402 does not store the key. Post-signature 402/503 release it (retry same key). Pre-reserve schema 400 does not store it. Other post-signature responses (2xx/4xx/5xx) are stored: same key+body replays; different body → 409. Stored 4xx/5xx replays are not a second charge. Prefer a new key after fixing a 4xx; after 5xx reuse the same key only for the stored error.\nPost-signature 402/503 include prior-payment-attempt (nonce, settled false|unknown). A facilitator 502 is SETTLEMENT_UNKNOWN (stored under the Idempotency-Key; cross-instance replay needs the shared store; may already be charged) — check USDC authorizationState(payer, nonce) on Base before re-signing.\nSettlement signal: settled 2xx include payment-response. 4xx/5xx do not. Do not book a cost from payment-signature alone.\nCoverage billing: HTTP 200 with status complete, partial, or failed is charged at the full listed price. Retrying missing checks needs a new settled call. 4xx/5xx are not charged.\nmissing_items.reason: timeout/rate_limited → one delayed retry (new key); upstream_down → after recovery; not_supported → never.\nInvariants: any missing_items ⇒ not status complete; sources[] is provenance only (source, url, retrievedAt), never success/error keyed by check.\nFree lookup: GET /api/v1/results/{result_id} returns stored coverage JSON (404 RESULT_NOT_FOUND if unknown/expired; not a 402). Prior-Result-Id sets replaces_result_id.\nOutputs are prechecks/drafts for human review — not official determinations, legal advice, or certified filings."},"servers":[{"url":"https://www.brainiac.software"}],"paths":{"/api/v1/equity-analytics/financial-ratios":{"post":{"operationId":"compute_standard_financial_ratios","summary":"Compute standard financial ratios","description":"Profitability, liquidity, leverage, efficiency and valuation ratios from caller-supplied statements and an optional price. Missing fields yield null metrics; division by zero is reported.","tags":["equity-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"statements":{"minItems":1,"maxItems":40,"type":"array","items":{"type":"object","properties":{"period":{"type":"string","minLength":1,"maxLength":32},"revenue":{"type":"number"},"cogs":{"type":"number"},"sga":{"type":"number"},"depreciation":{"type":"number"},"ebit":{"type":"number"},"interestExpense":{"type":"number"},"netIncome":{"type":"number"},"cfo":{"type":"number"},"capex":{"type":"number"},"totalAssets":{"type":"number"},"currentAssets":{"type":"number"},"currentLiabilities":{"type":"number"},"totalLiabilities":{"type":"number"},"longTermDebt":{"type":"number"},"receivables":{"type":"number"},"inventory":{"type":"number"},"ppeNet":{"type":"number"},"retainedEarnings":{"type":"number"},"sharesOutstanding":{"type":"number"},"dividendsPaid":{"type":"number"},"equity":{"type":"number"},"cash":{"type":"number"},"securities":{"type":"number"},"priorTotalAssets":{"type":"number"},"ebt":{"type":"number"}},"required":["period"],"additionalProperties":false}},"price":{"type":"number","exclusiveMinimum":0},"unit":{"default":"USD thousands","type":"string","minLength":1,"maxLength":64}},"required":["statements"],"additionalProperties":false},"example":{"statements":[{"period":"FY2025","revenue":1000,"cogs":550,"ebit":300,"interestExpense":10,"netIncome":250,"cfo":280,"capex":80,"totalAssets":900,"currentAssets":400,"currentLiabilities":450,"totalLiabilities":700,"longTermDebt":250,"receivables":82,"inventory":40,"equity":200,"sharesOutstanding":38,"cash":50}],"price":190.5,"unit":"USD thousands"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"periods":{"type":"array","items":{"type":"object","properties":{"period":{"type":"string"},"grossMargin":{"type":"number"},"operatingMargin":{"type":"number"},"netMargin":{"type":"number"},"roa":{"type":"number"},"roe":{"type":"number"},"currentRatio":{"type":"number"},"quickRatio":{"type":"number"},"debtToEquity":{"type":"number"},"interestCoverage":{"type":"number"},"assetTurnover":{"type":"number"},"inventoryTurnover":{"type":"number"},"dso":{"type":"number"},"pe":{"type":"number"},"pb":{"type":"number"},"evToEbit":{"type":"number"},"fcfYield":{"type":"number"},"missing":{"type":"array","items":{}},"reasons":{"type":"object","properties":{},"additionalProperties":true}},"additionalProperties":true}},"unit":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"periods":[{"period":"FY2025","grossMargin":0.45,"operatingMargin":0.3,"netMargin":0.25,"roa":0.2777777777777778,"roe":1.25,"currentRatio":0.8888888888888888,"quickRatio":0.8,"debtToEquity":3.5,"interestCoverage":30,"assetTurnover":1.1111111111111112,"inventoryTurnover":13.75,"dso":29.93,"pe":28.956,"pb":36.195,"evToEbit":24.796666666666667,"fcfYield":0.02762812543168946,"missing":[],"reasons":{}}],"unit":"USD thousands","sources":[{"source":"Caller-supplied statements, prices and identifiers processed locally","url":"https://www.brainiac.software/api/v1/equity-analytics","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Ratios use caller-supplied statement fields only. Missing inputs yield null metrics listed under missing; division by z…","ROA and ROE use average assets/equity when a prior period is present, otherwise year-end values.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/equity-analytics/dcf-valuation":{"post":{"operationId":"two_stage_discounted_cash_flow","summary":"Two-stage discounted cash flow","description":"Discount explicit free cash flows and a Gordon or exit-multiple terminal value to enterprise and equity value per share, with a discount-rate and growth sensitivity grid.","tags":["equity-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"fcf":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"number"}},"discountRate":{"type":"number","exclusiveMinimum":0,"exclusiveMaximum":1},"terminal":{"type":"object","properties":{"method":{"type":"string","enum":["gordon","exit_multiple"]},"growth":{"type":"number","exclusiveMinimum":-1,"exclusiveMaximum":1},"multiple":{"type":"number","exclusiveMinimum":0},"metric":{"type":"number"}},"required":["method"],"additionalProperties":false},"netDebt":{"default":0,"type":"number"},"sharesOutstanding":{"type":"number","exclusiveMinimum":0},"midYear":{"default":false,"type":"boolean"}},"required":["fcf","discountRate","terminal","sharesOutstanding"],"additionalProperties":false},"example":{"fcf":[100,110,120],"discountRate":0.08,"terminal":{"method":"gordon","growth":0.02},"netDebt":200,"sharesOutstanding":50,"midYear":false}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"pvExplicit":{"type":"number"},"terminalValue":{"type":"number"},"pvTerminal":{"type":"number"},"enterpriseValue":{"type":"number"},"equityValue":{"type":"number"},"perShare":{"type":"number"},"sensitivity":{"type":"array","items":{"type":"object","properties":{"discountRate":{"type":"number"},"growth":{"type":"number"},"perShare":{"type":"number"}},"additionalProperties":true}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"pvExplicit":282.159732,"terminalValue":2040,"pvTerminal":1619.417772,"enterpriseValue":1901.577503,"equityValue":1701.577503,"perShare":34.03155,"sensitivity":[{"discountRate":0.07,"growth":0.015,"perShare":37.904414},{"discountRate":0.07,"growth":0.02,"perShare":41.715783},"…"],"sources":[{"source":"Caller-supplied statements, prices and identifiers processed locally","url":"https://www.brainiac.software/api/v1/equity-analytics","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Two-stage DCF on caller FCF only. Gordon terminal requires growth < discountRate (invalid_growth otherwise).","Exit-multiple terminal value is multiple × metric at year N as supplied; no separate forecast is built.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/equity-analytics/wacc-calculate":{"post":{"operationId":"weighted_average_cost_of_capital","summary":"Weighted average cost of capital","description":"CAPM cost of equity and after-tax cost of debt combined into WACC from supplied equity and debt values.","tags":["equity-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"equityValue":{"type":"number","exclusiveMinimum":0},"debtValue":{"type":"number","minimum":0},"riskFree":{"type":"number"},"beta":{"type":"number"},"equityRiskPremium":{"type":"number"},"costOfDebt":{"type":"number"},"taxRate":{"type":"number","minimum":0,"maximum":1},"sizePremium":{"default":0,"type":"number"}},"required":["equityValue","debtValue","riskFree","beta","equityRiskPremium","costOfDebt","taxRate"],"additionalProperties":false},"example":{"equityValue":600,"debtValue":400,"riskFree":0.04,"beta":1.2,"equityRiskPremium":0.05,"costOfDebt":0.05,"taxRate":0.25,"sizePremium":0}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"costOfEquity":{"type":"number"},"afterTaxCostOfDebt":{"type":"number"},"weights":{"type":"object","properties":{"equity":{"type":"number"},"debt":{"type":"number"}},"additionalProperties":true},"wacc":{"type":"number"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"costOfEquity":0.1,"afterTaxCostOfDebt":0.0375,"weights":{"equity":0.6,"debt":0.4},"wacc":0.075,"sources":[{"source":"Caller-supplied statements, prices and identifiers processed locally","url":"https://www.brainiac.software/api/v1/equity-analytics","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Cost of equity is CAPM: riskFree + beta × equityRiskPremium + sizePremium.","WACC uses supplied equity and debt market values; no target capital structure is inferred.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/equity-analytics/beta-regression":{"post":{"operationId":"ols_equity_beta_vs_a_benchmark","summary":"OLS equity beta vs a benchmark","description":"Align asset and benchmark closes, compute simple returns at daily, weekly or monthly frequency, and return OLS beta, alpha, R², standard error and optional Blume-adjusted beta.","tags":["equity-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"assetPrices":{"minItems":21,"maxItems":10000,"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"close":{"type":"number","exclusiveMinimum":0}},"required":["date","close"],"additionalProperties":false}},"benchmarkPrices":{"minItems":21,"maxItems":10000,"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"close":{"type":"number","exclusiveMinimum":0}},"required":["date","close"],"additionalProperties":false}},"frequency":{"default":"daily","type":"string","enum":["daily","weekly","monthly"]},"blumeAdjust":{"default":true,"type":"boolean"}},"required":["assetPrices","benchmarkPrices"],"additionalProperties":false},"example":{"assetPrices":[{"date":"2024-02-01","close":100},{"date":"2024-02-02","close":102},{"date":"2024-02-03","close":104.03999999999999},{"date":"2024-02-04","close":106.12080000000002},{"date":"2024-02-05","close":108.243216},{"date":"2024-02-06","close":110.40808032},{"date":"2024-02-07","close":112.61624192640001},{"date":"2024-02-08","close":114.868566764928},{"date":"2024-02-09","close":117.16593810022657},{"date":"2024-02-10","close":119.50925686223111},{"date":"2024-02-11","close":121.89944199947573},{"date":"2024-02-12","close":124.33743083946524},{"date":"2024-02-13","close":126.82417945625457},{"date":"2024-02-14","close":129.36066304537965},{"date":"2024-02-15","close":131.94787630628724},{"date":"2024-02-16","close":134.586833832413},{"date":"2024-02-17","close":137.27857050906124},{"date":"2024-02-18","close":140.02414191924248},{"date":"2024-02-19","close":142.82462475762733},{"date":"2024-02-20","close":145.68111725277987},{"date":"2024-02-21","close":148.59473959783548},{"date":"2024-02-22","close":151.5666343897922},{"date":"2024-02-23","close":154.59796707758804},{"date":"2024-02-24","close":157.68992641913982},{"date":"2024-02-25","close":160.84372494752262}],"benchmarkPrices":[{"date":"2024-02-01","close":100},{"date":"2024-02-02","close":101},{"date":"2024-02-03","close":102.01},{"date":"2024-02-04","close":103.03010000000002},{"date":"2024-02-05","close":104.060401},{"date":"2024-02-06","close":105.10100501000001},{"date":"2024-02-07","close":106.15201506010001},{"date":"2024-02-08","close":107.21353521070101},{"date":"2024-02-09","close":108.28567056280802},{"date":"2024-02-10","close":109.36852726843608},{"date":"2024-02-11","close":110.46221254112045},{"date":"2024-02-12","close":111.56683466653166},{"date":"2024-02-13","close":112.68250301319698},{"date":"2024-02-14","close":113.80932804332895},{"date":"2024-02-15","close":114.94742132376223},{"date":"2024-02-16","close":116.09689553699987},{"date":"2024-02-17","close":117.25786449236988},{"date":"2024-02-18","close":118.43044313729357},{"date":"2024-02-19","close":119.6147475686665},{"date":"2024-02-20","close":120.81089504435316},{"date":"2024-02-21","close":122.0190039947967},{"date":"2024-02-22","close":123.23919403474468},{"date":"2024-02-23","close":124.47158597509211},{"date":"2024-02-24","close":125.71630183484304},{"date":"2024-02-25","close":126.97346485319147}],"frequency":"daily","blumeAdjust":true}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"beta":{"type":"number"},"adjustedBeta":{"type":"number"},"alpha":{"type":"number"},"r2":{"type":"number"},"stdErrBeta":{"type":"number"},"n":{"type":"number"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"beta":0.3570770905,"adjustedBeta":0.5692416506,"alpha":0.016429229095,"r2":0.251320132,"stdErrBeta":0.1313843441,"n":24,"sources":[{"source":"Caller-supplied statements, prices and identifiers processed locally","url":"https://www.brainiac.software/api/v1/equity-analytics","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Dates are inner-joined after resampling to the last close of each day, ISO week or calendar month.","Beta uses sample covariance and variance (n − 1). Blume adjustment is 0.67β + 0.33 when blumeAdjust is true.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/equity-analytics/corporate-action-adjust":{"post":{"operationId":"back_adjust_prices_for_splits_and_dividends","summary":"Back-adjust prices for splits and dividends","description":"Apply split and cash-dividend factors backwards through a price series (CRSP-style multiplicative dividends) and return adjusted closes, volumes and cumulative factors.","tags":["equity-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"prices":{"minItems":1,"maxItems":20000,"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"close":{"type":"number","exclusiveMinimum":0},"volume":{"default":0,"type":"number","minimum":0}},"required":["date","close"],"additionalProperties":false}},"actions":{"default":[],"maxItems":500,"type":"array","items":{"oneOf":[{"type":"object","properties":{"exDate":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"type":{"type":"string","const":"split"},"ratio":{"type":"number","exclusiveMinimum":0}},"required":["exDate","type","ratio"],"additionalProperties":false},{"type":"object","properties":{"exDate":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"type":{"type":"string","const":"dividend"},"amount":{"type":"number"}},"required":["exDate","type","amount"],"additionalProperties":false}]}}},"required":["prices"],"additionalProperties":false},"example":{"prices":[{"date":"2024-01-01","close":100,"volume":1000},{"date":"2024-01-02","close":25,"volume":4000},{"date":"2024-01-03","close":25.5,"volume":4100}],"actions":[{"exDate":"2024-01-02","type":"split","ratio":4}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"adjusted":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"close":{"type":"number"},"volume":{"type":"number"},"factor":{"type":"number"}},"additionalProperties":true}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"adjusted":[{"date":"2024-01-01","close":25,"volume":4000,"factor":0.25},{"date":"2024-01-02","close":25,"volume":4000,"factor":1},"…"],"sources":[{"source":"Caller-supplied statements, prices and identifiers processed locally","url":"https://www.brainiac.software/api/v1/equity-analytics","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Split ratio is new shares per old share: closes before exDate are divided by the ratio and volumes multiplied.","Cash dividends use a CRSP-style multiplicative factor 1 − D / prior close, compounded backwards with splits.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/equity-analytics/total-return-series":{"post":{"operationId":"build_a_dividend_reinvested_total_return_index","summary":"Build a dividend-reinvested total-return index","description":"Compound a total-return index from closes and cash dividends with optional withholding tax, and report price return, total return and CAGR.","tags":["equity-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"prices":{"minItems":2,"maxItems":20000,"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"close":{"type":"number","exclusiveMinimum":0}},"required":["date","close"],"additionalProperties":false}},"dividends":{"default":[],"maxItems":2000,"type":"array","items":{"type":"object","properties":{"exDate":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"amount":{"type":"number"}},"required":["exDate","amount"],"additionalProperties":false}},"base":{"default":100,"type":"number","exclusiveMinimum":0},"withholdingTax":{"default":0,"type":"number","minimum":0,"maximum":1}},"required":["prices"],"additionalProperties":false},"example":{"prices":[{"date":"2024-01-01","close":100},{"date":"2025-01-01","close":110}],"dividends":[{"exDate":"2025-01-01","amount":2}],"base":100,"withholdingTax":0}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"index":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":"number"}},"additionalProperties":true}},"priceReturn":{"type":"number"},"totalReturn":{"type":"number"},"cagr":{"type":"number"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"index":[{"date":"2024-01-01","value":100},{"date":"2025-01-01","value":112}],"priceReturn":0.1,"totalReturn":0.12,"cagr":0.1197399316,"sources":[{"source":"Caller-supplied statements, prices and identifiers processed locally","url":"https://www.brainiac.software/api/v1/equity-analytics","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Daily total return on an ex-date is (close + dividend × (1 − withholdingTax)) / prior close − 1; the index compounds fr…","priceReturn ignores dividends. CAGR uses an actual/365.25 year fraction between the first and last dates.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/equity-analytics/altman-z-score":{"post":{"operationId":"altman_z_z_and_z_scores","summary":"Altman Z, Z′ and Z″ scores","description":"Compute the public manufacturing Z-score, private Z′ or non-manufacturing Z″ with published safe/grey/distress zones from caller-supplied balance-sheet and income items.","tags":["equity-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"variant":{"type":"string","enum":["Z","Z_prime","Z_double_prime"]},"workingCapital":{"type":"number"},"retainedEarnings":{"type":"number"},"ebit":{"type":"number"},"marketValueEquity":{"type":"number"},"bookEquity":{"type":"number"},"sales":{"type":"number"},"totalAssets":{"type":"number","exclusiveMinimum":0},"totalLiabilities":{"type":"number"}},"required":["variant","workingCapital","retainedEarnings","ebit","totalAssets"],"additionalProperties":false},"example":{"variant":"Z","workingCapital":100,"retainedEarnings":200,"ebit":100,"marketValueEquity":1500,"sales":1200,"totalAssets":1000,"totalLiabilities":1000}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"score":{"type":"number"},"zone":{"type":"string"},"components":{"type":"object","properties":{"x1":{"type":"number"},"x2":{"type":"number"},"x3":{"type":"number"},"x4":{"type":"number"},"x5":{"type":"number"}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"score":2.83,"zone":"grey","components":{"x1":0.1,"x2":0.2,"x3":0.1,"x4":1.5,"x5":1.2},"sources":[{"source":"Altman Z-score models (Altman 1968, 1983, 2000)","url":"https://en.wikipedia.org/wiki/Altman_Z-score","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Z is the public manufacturing model; Z_prime uses book equity; Z_double_prime omits the sales/assets term.","Zone cut-offs follow the published bands for each variant. This is a screening aid, not a credit rating.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/equity-analytics/piotroski-f-score":{"post":{"operationId":"piotroski_f_score_0_9","summary":"Piotroski F-score (0–9)","description":"Nine binary profitability, leverage, liquidity and operating-efficiency tests from two years of statements.","tags":["equity-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"current":{"type":"object","properties":{"period":{"type":"string","minLength":1,"maxLength":32},"revenue":{"type":"number"},"cogs":{"type":"number"},"sga":{"type":"number"},"depreciation":{"type":"number"},"ebit":{"type":"number"},"interestExpense":{"type":"number"},"netIncome":{"type":"number"},"cfo":{"type":"number"},"capex":{"type":"number"},"totalAssets":{"type":"number"},"currentAssets":{"type":"number"},"currentLiabilities":{"type":"number"},"totalLiabilities":{"type":"number"},"longTermDebt":{"type":"number"},"receivables":{"type":"number"},"inventory":{"type":"number"},"ppeNet":{"type":"number"},"retainedEarnings":{"type":"number"},"sharesOutstanding":{"type":"number"},"dividendsPaid":{"type":"number"},"equity":{"type":"number"},"cash":{"type":"number"},"securities":{"type":"number"},"priorTotalAssets":{"type":"number"},"ebt":{"type":"number"}},"additionalProperties":false},"prior":{"type":"object","properties":{"period":{"type":"string","minLength":1,"maxLength":32},"revenue":{"type":"number"},"cogs":{"type":"number"},"sga":{"type":"number"},"depreciation":{"type":"number"},"ebit":{"type":"number"},"interestExpense":{"type":"number"},"netIncome":{"type":"number"},"cfo":{"type":"number"},"capex":{"type":"number"},"totalAssets":{"type":"number"},"currentAssets":{"type":"number"},"currentLiabilities":{"type":"number"},"totalLiabilities":{"type":"number"},"longTermDebt":{"type":"number"},"receivables":{"type":"number"},"inventory":{"type":"number"},"ppeNet":{"type":"number"},"retainedEarnings":{"type":"number"},"sharesOutstanding":{"type":"number"},"dividendsPaid":{"type":"number"},"equity":{"type":"number"},"cash":{"type":"number"},"securities":{"type":"number"},"priorTotalAssets":{"type":"number"},"ebt":{"type":"number"}},"additionalProperties":false}},"required":["current","prior"],"additionalProperties":false},"example":{"current":{"revenue":110,"cogs":40,"netIncome":12,"cfo":18,"totalAssets":100,"currentAssets":55,"currentLiabilities":20,"longTermDebt":8,"sharesOutstanding":10,"priorTotalAssets":90},"prior":{"revenue":90,"cogs":40,"netIncome":5,"cfo":6,"totalAssets":90,"currentAssets":40,"currentLiabilities":20,"longTermDebt":15,"sharesOutstanding":10,"priorTotalAssets":80}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"score":{"type":"number"},"tests":{"type":"object","properties":{"roaPositive":{"type":"boolean"},"cfoPositive":{"type":"boolean"},"roaImproved":{"type":"boolean"},"accrual":{"type":"boolean"},"leverageDown":{"type":"boolean"},"currentRatioUp":{"type":"boolean"},"noDilution":{"type":"boolean"},"grossMarginUp":{"type":"boolean"},"assetTurnoverUp":{"type":"boolean"}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"score":9,"tests":{"roaPositive":true,"cfoPositive":true,"roaImproved":true,"accrual":true,"leverageDown":true,"currentRatioUp":true,"noDilution":true,"grossMarginUp":true,"assetTurnoverUp":true},"sources":[{"source":"Piotroski F-score (Piotroski 2000)","url":"https://en.wikipedia.org/wiki/Piotroski_F-score","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Nine binary tests from Piotroski (2000). ROA uses priorTotalAssets when supplied, otherwise year-end totalAssets.","A missing input needed for a test makes that test false.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/equity-analytics/beneish-m-score":{"post":{"operationId":"beneish_eight_variable_m_score","summary":"Beneish eight-variable M-score","description":"Compute DSRI, GMI, AQI, SGI, DEPI, SGAI, LVGI and TATA and the Beneish (1999) M-score with the −1.78 flag threshold.","tags":["equity-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"current":{"type":"object","properties":{"period":{"type":"string","minLength":1,"maxLength":32},"revenue":{"type":"number"},"cogs":{"type":"number"},"sga":{"type":"number"},"depreciation":{"type":"number"},"ebit":{"type":"number"},"interestExpense":{"type":"number"},"netIncome":{"type":"number"},"cfo":{"type":"number"},"capex":{"type":"number"},"totalAssets":{"type":"number"},"currentAssets":{"type":"number"},"currentLiabilities":{"type":"number"},"totalLiabilities":{"type":"number"},"longTermDebt":{"type":"number"},"receivables":{"type":"number"},"inventory":{"type":"number"},"ppeNet":{"type":"number"},"retainedEarnings":{"type":"number"},"sharesOutstanding":{"type":"number"},"dividendsPaid":{"type":"number"},"equity":{"type":"number"},"cash":{"type":"number"},"securities":{"type":"number"},"priorTotalAssets":{"type":"number"},"ebt":{"type":"number"}},"additionalProperties":false},"prior":{"type":"object","properties":{"period":{"type":"string","minLength":1,"maxLength":32},"revenue":{"type":"number"},"cogs":{"type":"number"},"sga":{"type":"number"},"depreciation":{"type":"number"},"ebit":{"type":"number"},"interestExpense":{"type":"number"},"netIncome":{"type":"number"},"cfo":{"type":"number"},"capex":{"type":"number"},"totalAssets":{"type":"number"},"currentAssets":{"type":"number"},"currentLiabilities":{"type":"number"},"totalLiabilities":{"type":"number"},"longTermDebt":{"type":"number"},"receivables":{"type":"number"},"inventory":{"type":"number"},"ppeNet":{"type":"number"},"retainedEarnings":{"type":"number"},"sharesOutstanding":{"type":"number"},"dividendsPaid":{"type":"number"},"equity":{"type":"number"},"cash":{"type":"number"},"securities":{"type":"number"},"priorTotalAssets":{"type":"number"},"ebt":{"type":"number"}},"additionalProperties":false}},"required":["current","prior"],"additionalProperties":false},"example":{"current":{"revenue":100,"cogs":60,"receivables":10,"currentAssets":40,"ppeNet":30,"totalAssets":100,"depreciation":5,"sga":10,"netIncome":10,"cfo":10,"currentLiabilities":20,"longTermDebt":10},"prior":{"revenue":100,"cogs":60,"receivables":10,"currentAssets":40,"ppeNet":30,"totalAssets":100,"depreciation":5,"sga":10,"netIncome":10,"cfo":10,"currentLiabilities":20,"longTermDebt":10}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"m":{"type":"number"},"flag":{"type":"boolean"},"threshold":{"type":"number"},"indices":{"type":"object","properties":{"DSRI":{"type":"number"},"GMI":{"type":"number"},"AQI":{"type":"number"},"SGI":{"type":"number"},"DEPI":{"type":"number"},"SGAI":{"type":"number"},"LVGI":{"type":"number"},"TATA":{"type":"number"}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"m":-2.48,"flag":false,"threshold":-1.78,"indices":{"DSRI":1,"GMI":1,"AQI":1,"SGI":1,"DEPI":1,"SGAI":1,"LVGI":1,"TATA":0},"sources":[{"source":"Beneish M-score eight-variable model (Beneish 1999)","url":"https://en.wikipedia.org/wiki/Beneish_M-score","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Eight-variable Beneish (1999) model. Indices that cannot be formed from the supplied fields default to 1 (TATA to 0).","flag is true when M > −1.78. This is a screening statistic, not proof of earnings manipulation.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/equity-analytics/dupont-analysis":{"post":{"operationId":"three_and_five_step_dupont_roe","summary":"Three- and five-step DuPont ROE","description":"Decompose ROE into net margin, asset turnover and equity multiplier, and optionally the five-step tax, interest and EBIT-margin path.","tags":["equity-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"netIncome":{"type":"number"},"revenue":{"type":"number"},"totalAssets":{"type":"number","exclusiveMinimum":0},"equity":{"type":"number","exclusiveMinimum":0},"ebt":{"type":"number"},"ebit":{"type":"number"}},"required":["netIncome","revenue","totalAssets","equity"],"additionalProperties":false},"example":{"netIncome":150,"revenue":1000,"totalAssets":800,"equity":400,"ebt":200,"ebit":220}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"threeStep":{"type":"object","properties":{"netMargin":{"type":"number"},"assetTurnover":{"type":"number"},"equityMultiplier":{"type":"number"},"roe":{"type":"number"}},"additionalProperties":true},"fiveStep":{"type":"object","properties":{"taxBurden":{"type":"number"},"interestBurden":{"type":"number"},"ebitMargin":{"type":"number"},"assetTurnover":{"type":"number"},"equityMultiplier":{"type":"number"},"roe":{"type":"number"}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"threeStep":{"netMargin":0.15,"assetTurnover":1.25,"equityMultiplier":2,"roe":0.375},"fiveStep":{"taxBurden":0.75,"interestBurden":0.9090909091,"ebitMargin":0.22,"assetTurnover":1.25,"equityMultiplier":2,"roe":0.375},"sources":[{"source":"Caller-supplied statements, prices and identifiers processed locally","url":"https://www.brainiac.software/api/v1/equity-analytics","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Three-step ROE is net margin × asset turnover × equity multiplier. Five-step needs ebt and ebit.","Outputs are calculations on caller-supplied inputs for human review. No market data is fetched, and this is not investm…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/equity-analytics/peer-multiples":{"post":{"operationId":"peer_multiple_stats_and_implied_value","summary":"Peer multiple stats and implied value","description":"Summarise peer EV/EBITDA, P/E and related multiples with optional IQR trimming, and imply enterprise, equity and per-share values for a target.","tags":["equity-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"target":{"type":"object","properties":{"ebitda":{"type":"number"},"netDebt":{"default":0,"type":"number"},"shares":{"type":"number","exclusiveMinimum":0},"netIncome":{"type":"number"},"equity":{"type":"number"},"sales":{"type":"number"},"revenue":{"type":"number"}},"additionalProperties":false},"peers":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":64},"evToEbitda":{"type":"number"},"pe":{"type":"number"},"pb":{"type":"number"},"evToSales":{"type":"number"},"ps":{"type":"number"}},"required":["name"],"additionalProperties":false}},"multiples":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","enum":["evToEbitda","pe","pb","evToSales","ps"]}},"trimOutliersIqr":{"default":false,"type":"boolean"}},"required":["target","peers","multiples"],"additionalProperties":false},"example":{"target":{"ebitda":100,"netDebt":50,"shares":10,"netIncome":60},"peers":[{"name":"A","evToEbitda":8},{"name":"B","evToEbitda":10},{"name":"C","evToEbitda":12}],"multiples":["evToEbitda"],"trimOutliersIqr":true}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"stats":{"type":"object","properties":{"evToEbitda":{"type":"object","properties":{"min":{"type":"number"},"median":{"type":"number"},"mean":{"type":"number"},"max":{"type":"number"},"n":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true},"implied":{"type":"object","properties":{"evToEbitda":{"type":"object","properties":{"ev":{"type":"number"},"equity":{"type":"number"},"perShare":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"stats":{"evToEbitda":{"min":8,"median":10,"mean":10,"max":12,"n":3}},"implied":{"evToEbitda":{"ev":1000,"equity":950,"perShare":95}},"sources":[{"source":"Caller-supplied statements, prices and identifiers processed locally","url":"https://www.brainiac.software/api/v1/equity-analytics","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Negative and missing peer multiples are dropped. Optional 1.5×IQR trimming uses sample quartiles.","Implied equity for EV multiples is median × target metric − netDebt.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/equity-analytics/dividend-metrics":{"post":{"operationId":"dividend_yield_payout_coverage_and_cagr","summary":"Dividend yield, payout, coverage and CAGR","description":"Compute trailing yield, payout ratio, FCF coverage and DPS CAGR from a price and a dividends-per-share series.","tags":["equity-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"price":{"type":"number","exclusiveMinimum":0},"dividendsPerShare":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"dps":{"type":"number","minimum":0}},"required":["year","dps"],"additionalProperties":false}},"eps":{"type":"number"},"fcfPerShare":{"type":"number"}},"required":["price","dividendsPerShare"],"additionalProperties":false},"example":{"price":50,"dividendsPerShare":[{"year":2021,"dps":1},{"year":2025,"dps":1.4641}],"eps":3,"fcfPerShare":2.5}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"yield":{"type":"number"},"payoutRatio":{"type":"number"},"fcfCoverage":{"type":"number"},"cagr":{"type":"number"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"yield":0.029282,"payoutRatio":0.4880333333,"fcfCoverage":1.7075336384,"cagr":0.1,"sources":[{"source":"Caller-supplied statements, prices and identifiers processed locally","url":"https://www.brainiac.software/api/v1/equity-analytics","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Yield uses the latest DPS / price. CAGR uses (last/first)^(1/years) − 1 over the year span of the series.","Outputs are calculations on caller-supplied inputs for human review. No market data is fetched, and this is not investm…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/equity-analytics/security-identifier-validate":{"post":{"operationId":"validate_isin_cusip_and_sedol_check_digits","summary":"Validate ISIN, CUSIP and SEDOL check digits","description":"Detect identifier type by pattern, validate check digits, and optionally convert CUSIP or SEDOL to ISIN. Existence is not confirmed.","tags":["equity-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"identifiers":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":20}},"toIsin":{"type":"object","properties":{"country":{"type":"string","minLength":2,"maxLength":2}},"required":["country"],"additionalProperties":false}},"required":["identifiers"],"additionalProperties":false},"example":{"identifiers":["US0378331005","037833100","0263494"],"toIsin":{"country":"US"}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"input":{"type":"string"},"type":{"type":"string"},"valid":{"type":"boolean"},"isin":{"type":"string"}},"additionalProperties":true}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"results":[{"input":"US0378331005","type":"ISIN","valid":true},{"input":"037833100","type":"CUSIP","valid":true,"isin":"US0378331005"},"…"],"sources":[{"source":"ISIN ISO 6166, CUSIP check digit, SEDOL check digit","url":"https://www.iso.org/standard/78502.html","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Validates check digits and structure only. Existence on an exchange or in a directory is not confirmed; no CUSIP/ISIN/L…","CUSIP→ISIN uses the supplied toIsin.country (US or CA, default US). SEDOL→ISIN uses GB00 + SEDOL + ISIN check digit.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/equity-analytics/lei-validate":{"post":{"operationId":"validate_an_lei_check_digits","summary":"Validate an LEI check digits","description":"Check ISO 17442 structure and ISO/IEC 7064 MOD 97-10 check digits for a Legal Entity Identifier. Registration status is not looked up.","tags":["equity-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"lei":{"type":"string","minLength":18,"maxLength":24}},"required":["lei"],"additionalProperties":false},"example":{"lei":"HWUPKR0MPOU8FGXBT394"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"valid":{"type":"boolean"},"louPrefix":{"type":"string"},"checkDigits":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"valid":true,"louPrefix":"HWUP","checkDigits":"94","sources":[{"source":"ISO 17442 LEI structure and ISO/IEC 7064 MOD 97-10 check digits (GLEIF documentation)","url":"https://www.gleif.org/en/about-lei/iso-17442-the-lei-code-structure","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Validates ISO 17442 structure and ISO/IEC 7064 MOD 97-10 check digits only.","Does not confirm the LEI is registered or active; no GLEIF data is bundled.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}