{"openapi":"3.1.0","info":{"title":"A/B Testing & Experimentation Statistics API","version":"1.0.0","description":"Frequentist, Bayesian, sequential and CUPED A/B test analysis, sample ratio mismatch, sample size and MDE, multiple-testing correction, delta-method ratio metrics, bandit allocation, deterministic bucketing, feature-flag rule evaluation, novelty detection, segment lift, guardrail and holdout checks. Pure computation on the numbers you send. 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/experimentation/ab-test-frequentist":{"post":{"operationId":"run_a_frequentist_a_b_test_scorecard","summary":"Run a frequentist A/B test scorecard","description":"Two-arm A/B scorecard for conversion (two-proportion z) or continuous (Welch t) metrics: absolute and relative lift, confidence intervals, p-value and significance. Pure computation on supplied aggregates.","tags":["experimentation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"metricType":{"type":"string","enum":["proportion","mean"]},"alpha":{"default":0.05,"type":"number","exclusiveMinimum":0,"exclusiveMaximum":0.5},"alternative":{"default":"two-sided","type":"string","enum":["two-sided","greater","less"]},"control":{"anyOf":[{"type":"object","properties":{"users":{"type":"integer","minimum":1,"maximum":9007199254740991},"conversions":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["users","conversions"],"additionalProperties":false},{"type":"object","properties":{"n":{"type":"integer","minimum":2,"maximum":9007199254740991},"mean":{"type":"number"},"sd":{"type":"number","minimum":0}},"required":["n","mean","sd"],"additionalProperties":false}]},"treatment":{"anyOf":[{"type":"object","properties":{"users":{"type":"integer","minimum":1,"maximum":9007199254740991},"conversions":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["users","conversions"],"additionalProperties":false},{"type":"object","properties":{"n":{"type":"integer","minimum":2,"maximum":9007199254740991},"mean":{"type":"number"},"sd":{"type":"number","minimum":0}},"required":["n","mean","sd"],"additionalProperties":false}]}},"required":["metricType","control","treatment"],"additionalProperties":false},"example":{"metricType":"proportion","alpha":0.05,"alternative":"two-sided","control":{"users":10000,"conversions":1000},"treatment":{"users":10000,"conversions":1100}}}}},"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":{"controlRate":{"type":"number"},"treatmentRate":{"type":"number"},"absoluteLift":{"type":"number"},"absoluteCi":{"type":"array","items":{"type":"number"}},"relativeLift":{"type":"number"},"relativeCi":{"type":"array","items":{"type":"number"}},"statistic":{"type":"number"},"pValue":{"type":"number"},"significant":{"type":"boolean"},"test":{"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":{"controlRate":0.1,"treatmentRate":0.11,"absoluteLift":0.01,"absoluteCi":[0.001504059132,0.01849594087],"relativeLift":0.1,"relativeCi":[0.01087011253,0.1891298875],"statistic":2.306634774,"pValue":0.02107518927,"significant":true,"test":"two-proportion z (pooled SE for test, unpooled SE for CI)","sources":[{"source":"NIST/SEMATECH e-Handbook: two-sample t-test (Welch)","url":"https://www.itl.nist.gov/div898/handbook/eda/section3/eda353.htm","retrievedAt":"2026-11-14T00:00:00.000Z","status":"ok"},{"source":"Deng, Knoblich, Lu (2018) Applying the Delta Method in Metric Analytics","url":"https://arxiv.org/abs/1803.06336","retrievedAt":"2026-11-14T00:00:00.000Z","status":"ok"}],"limitations":["Normal approximation: unreliable when expected successes or failures per arm are below about 10. Relative-lift interval…","Pure computation on the supplied input: no events are stored and no network is called. Results are statistical calculat…"]}}}},"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/experimentation/bayesian-ab":{"post":{"operationId":"compare_a_b_arms_with_a_bayesian_beta_binomial_model","summary":"Compare A/B arms with a Bayesian Beta-Binomial model","description":"Posterior, probability to beat control, probability of being best, expected loss and equal-tailed credible intervals for 2-10 conversion arms. Deterministic: exact Miller sum or quadrature, no Monte Carlo.","tags":["experimentation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"prior":{"default":{"alpha":1,"beta":1},"type":"object","properties":{"alpha":{"default":1,"type":"number","exclusiveMinimum":0},"beta":{"default":1,"type":"number","exclusiveMinimum":0}},"additionalProperties":false},"arms":{"minItems":2,"maxItems":10,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":64},"control":{"type":"boolean"},"users":{"type":"integer","minimum":0,"maximum":9007199254740991},"conversions":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["name","users","conversions"],"additionalProperties":false}},"credibleLevel":{"default":0.95,"type":"number","exclusiveMinimum":0.5,"exclusiveMaximum":0.999}},"required":["arms"],"additionalProperties":false},"example":{"prior":{"alpha":1,"beta":1},"arms":[{"name":"A","users":10000,"conversions":1000},{"name":"B","users":10000,"conversions":1100}],"credibleLevel":0.95}}}},"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":{"arms":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"posterior":{"type":"object","properties":{"alpha":{"type":"number"},"beta":{"type":"number"}},"additionalProperties":true},"mean":{"type":"number"},"credible":{"type":"array","items":{"type":"number"}},"probBeatControl":{"type":["null","number"]},"probBest":{"type":"number"},"expectedLoss":{"type":"number"}},"additionalProperties":true}},"control":{"type":"string"},"credibleLevel":{"type":"number"},"method":{"type":"object","properties":{"probBeatControl":{"type":"string"},"probBest":{"type":"string"},"expectedLoss":{"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":{"arms":[{"name":"A","posterior":{"alpha":1001,"beta":9001},"mean":0.100079984,"credible":[0.09427511307,0.106036332],"probBeatControl":null,"probBest":0.01054264559,"expectedLoss":0.01001358271},{"name":"B","posterior":{"alpha":1101,"beta":8901},"mean":0.1100779844,"credible":[0.1040187816,0.1162848782],"probBeatControl":0.9894573544,"probBest":0.9894573544,"expectedLoss":0.00001558231261}],"control":"A","credibleLevel":0.95,"method":{"probBeatControl":"exact (Miller 2015)","probBest":"pairwise probability to beat control","expectedLoss":"deterministic Simpson quadrature of E[max_j p_j] minus posterior mean"},"sources":[{"source":"Miller (2015) Formulas for Bayesian A/B Testing","url":"https://www.evanmiller.org/bayesian-ab-testing.html","retrievedAt":"2026-11-14T00:00:00.000Z","status":"ok"}],"limitations":["Independent Beta-Binomial posteriors; no Monte Carlo, so results are reproducible. Quadrature spans the 1e-9 to 1-1e-9 …","Probabilities describe the posterior under the supplied prior, not the long-run error rate of a procedure.","…"]}}}},"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/experimentation/sequential-test":{"post":{"operationId":"compute_sequential_testing_boundaries_or_an_always_valid_p_value","summary":"Compute sequential testing boundaries or an always-valid p-value","description":"Lan-DeMets group-sequential boundaries (O'Brien-Fleming or Pocock spending) for planned looks with a stop/continue decision, or an always-valid mSPRT p-value for continuous monitoring.","tags":["experimentation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"mode":{"type":"string","enum":["group_sequential","msprt"]},"alpha":{"default":0.05,"type":"number","exclusiveMinimum":0,"exclusiveMaximum":0.5},"spending":{"default":"obrien_fleming","type":"string","enum":["obrien_fleming","pocock"]},"informationFractions":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"number","exclusiveMinimum":0,"maximum":1}},"observedZ":{"maxItems":20,"type":"array","items":{"type":["number","null"]}},"estimate":{"type":"number"},"variance":{"type":"number","exclusiveMinimum":0},"tau2":{"type":"number","exclusiveMinimum":0}},"required":["mode"],"additionalProperties":false},"example":{"mode":"group_sequential","alpha":0.05,"spending":"obrien_fleming","informationFractions":[0.2,0.4,0.6,0.8,1],"observedZ":[1.2,2.1,null,null,null]}}}},"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":{"boundaries":{"type":"array","items":{"type":"number"}},"cumulativeAlpha":{"type":"array","items":{"type":"number"}},"decision":{"type":"object","properties":{"look":{"type":"number"},"crossed":{"type":"boolean"},"boundary":{"type":"number"},"observedZ":{"type":"number"}},"additionalProperties":true},"spending":{"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":{"boundaries":[4.876884949,3.357011922,"…"],"cumulativeAlpha":[0.000001077742526,0.0007883035134,"…"],"decision":{"look":2,"crossed":false,"boundary":3.357011922,"observedZ":2.1},"spending":"obrien_fleming","sources":[{"source":"Lan & DeMets (1983) Discrete sequential boundaries for clinical trials, Biometrika 70(3)","url":"https://doi.org/10.1093/biomet/70.3.659","retrievedAt":"2026-11-14T00:00:00.000Z","status":"ok"}],"limitations":["Two-sided symmetric boundaries; the total type I error is alpha and each side spends alpha/2. Boundaries assume the pla…","Numerical recursion on a Simpson grid (at least 2,001 points) with bisection to 1e-9; agrees with published Lan-DeMets …","…"]}}}},"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/experimentation/cuped-adjust":{"post":{"operationId":"apply_cuped_variance_reduction_and_test_the_adjusted_effect","summary":"Apply CUPED variance reduction and test the adjusted effect","description":"CUPED adjustment with a pre-experiment covariate on unit-level data: theta, variance reduction, and Welch tests on raw and adjusted values.","tags":["experimentation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"units":{"minItems":4,"maxItems":200000,"type":"array","items":{"type":"object","properties":{"group":{"type":"string","minLength":1,"maxLength":64},"y":{"type":"number"},"x":{"type":["number","null"]}},"required":["group","y"],"additionalProperties":false}},"alpha":{"default":0.05,"type":"number","exclusiveMinimum":0,"exclusiveMaximum":0.5}},"required":["units"],"additionalProperties":false},"example":{"units":[{"group":"control","y":11,"x":10},{"group":"treatment","y":13,"x":12},{"group":"control","y":9,"x":9},{"group":"treatment","y":17,"x":15},{"group":"control","y":12,"x":11},{"group":"treatment","y":15,"x":14},{"group":"control","y":9,"x":8},{"group":"treatment","y":14,"x":13},{"group":"control","y":10,"x":10},{"group":"treatment","y":14,"x":12}],"alpha":0.05}}}},"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":{"theta":{"type":"number"},"varianceReduction":{"type":"number"},"raw":{"type":"object","properties":{"diff":{"type":"number"},"se":{"type":"number"},"pValue":{"type":"number"},"ci":{"type":"array","items":{"type":"number"}},"significant":{"type":"boolean"}},"additionalProperties":true},"adjusted":{"type":"object","properties":{"controlMean":{"type":"number"},"treatmentMean":{"type":"number"},"diff":{"type":"number"},"se":{"type":"number"},"pValue":{"type":"number"},"ci":{"type":"array","items":{"type":"number"}},"significant":{"type":"boolean"}},"additionalProperties":true},"groups":{"type":"object","properties":{"control":{"type":"string"},"treatment":{"type":"string"}},"additionalProperties":true},"unitsWithoutCovariate":{"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":{"theta":1.18018018,"varianceReduction":0.9602708298,"raw":{"diff":4.4,"se":0.894427191,"pValue":0.001242936514,"ci":[2.32934137,6.47065863],"significant":true},"adjusted":{"controlMean":12.32432432,"treatmentMean":12.47567568,"diff":0.1513513514,"se":0.3536446295,"pValue":0.679972045,"ci":[-0.6643475398,0.9670502425],"significant":false},"groups":{"control":"control","treatment":"treatment"},"unitsWithoutCovariate":0,"sources":[{"source":"Deng, Xu, Kohavi, Walker (2013) CUPED: improving sensitivity of controlled experiments","url":"https://www.exp-platform.com/Documents/2013-02-CUPED-ImprovingSensitivityOfControlledExperiments.pdf","retrievedAt":"2026-11-14T00:00:00.000Z","status":"ok"},{"source":"NIST/SEMATECH e-Handbook: two-sample t-test (Welch)","url":"https://www.itl.nist.gov/div898/handbook/eda/section3/eda353.htm","retrievedAt":"2026-11-14T00:00:00.000Z","status":"ok"}],"limitations":["theta is estimated on both groups pooled, as in the CUPED paper; the covariate must be measured before assignment or it…","Pure computation on the supplied input: no events are stored and no network is called. Results are statistical calculat…"]}}}},"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/experimentation/sample-ratio-mismatch":{"post":{"operationId":"detect_a_b_sample_ratio_mismatch","summary":"Detect A/B sample ratio mismatch","description":"Chi-square goodness-of-fit test of observed arm counts against expected traffic shares, with an exact binomial p-value for tiny two-arm counts and generic causes when a mismatch is flagged.","tags":["experimentation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"arms":{"minItems":2,"maxItems":20,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":64},"observed":{"type":"integer","minimum":0,"maximum":9007199254740991},"expectedShare":{"type":"number","exclusiveMinimum":0,"maximum":1}},"required":["name","observed","expectedShare"],"additionalProperties":false}},"threshold":{"default":0.0005,"type":"number","exclusiveMinimum":0,"exclusiveMaximum":1}},"required":["arms"],"additionalProperties":false},"example":{"arms":[{"name":"control","observed":50000,"expectedShare":0.5},{"name":"treatment","observed":49000,"expectedShare":0.5}],"threshold":0.0005}}}},"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":{"chiSquare":{"type":"number"},"df":{"type":"number"},"pValue":{"type":"number"},"srm":{"type":"boolean"},"threshold":{"type":"number"},"arms":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"observed":{"type":"number"},"expected":{"type":"number"},"deviationPct":{"type":"number"}},"additionalProperties":true}},"hints":{"type":"array","items":{}},"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":{"chiSquare":10.1010101,"df":1,"pValue":0.001481880775,"srm":false,"threshold":0.0005,"arms":[{"name":"control","observed":50000,"expected":49500,"deviationPct":1.01},{"name":"treatment","observed":49000,"expected":49500,"deviationPct":-1.01}],"hints":[],"sources":[{"source":"NIST/SEMATECH e-Handbook: chi-square goodness-of-fit test","url":"https://www.itl.nist.gov/div898/handbook/eda/section3/eda35f.htm","retrievedAt":"2026-11-14T00:00:00.000Z","status":"ok"}],"limitations":["A non-significant result does not prove assignment is balanced; the default threshold 0.0005 is conservative on purpose.","Pure computation on the supplied input: no events are stored and no network is called. Results are statistical calculat…"]}}}},"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"}}},"/api/v1/experimentation/sample-size-mde":{"post":{"operationId":"calculate_a_b_sample_size_or_minimum_detectable_effect","summary":"Calculate A/B sample size or minimum detectable effect","description":"Required users per arm and duration for a target minimum detectable effect, or the MDE for a fixed sample, for proportion or mean metrics with power, multi-arm Bonferroni and unequal allocation.","tags":["experimentation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"metricType":{"type":"string","enum":["proportion","mean"]},"baseline":{"type":"number","exclusiveMinimum":0,"exclusiveMaximum":1},"baselineSd":{"type":"number","exclusiveMinimum":0},"baselineMean":{"type":"number"},"mde":{"type":"number","exclusiveMinimum":0},"mdeType":{"default":"relative","type":"string","enum":["relative","absolute"]},"nPerArm":{"type":"integer","minimum":2,"maximum":9007199254740991},"alpha":{"default":0.05,"type":"number","exclusiveMinimum":0,"exclusiveMaximum":0.5},"alternative":{"default":"two-sided","type":"string","enum":["two-sided","greater","less"]},"power":{"default":0.8,"type":"number","exclusiveMinimum":0.5,"exclusiveMaximum":0.999},"arms":{"default":2,"type":"integer","minimum":2,"maximum":10},"allocation":{"minItems":2,"maxItems":10,"type":"array","items":{"type":"number","exclusiveMinimum":0,"exclusiveMaximum":1}},"dailyUsers":{"type":"number","exclusiveMinimum":0},"correction":{"default":"none","type":"string","enum":["bonferroni","none"]}},"required":["metricType"],"additionalProperties":false},"example":{"metricType":"proportion","baseline":0.1,"mde":0.1,"mdeType":"relative","alpha":0.05,"power":0.8,"arms":2,"allocation":[0.5,0.5],"dailyUsers":2000,"correction":"bonferroni"}}}},"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":{"nPerArm":{"type":"number"},"nByArm":{"type":"array","items":{"type":"number"}},"totalN":{"type":"number"},"days":{"type":"number"},"alphaPerComparison":{"type":"number"},"formula":{"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":{"nPerArm":14749,"nByArm":[14749,14749],"totalN":29498,"days":15,"alphaPerComparison":0.05,"formula":"unpooled normal approximation","sources":[{"source":"NIST/SEMATECH e-Handbook: sample sizes required for means","url":"https://www.itl.nist.gov/div898/handbook/prc/section2/prc222.htm","retrievedAt":"2026-11-14T00:00:00.000Z","status":"ok"}],"limitations":["Normal approximation; for small samples or rare events check the result by simulation.","Allocation index 0 is the control; every other arm is compared with it.","…"]}}}},"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"}}},"/api/v1/experimentation/multiple-testing-correct":{"post":{"operationId":"adjust_p_values_for_multiple_testing","summary":"Adjust p-values for multiple testing","description":"Bonferroni, Holm and Benjamini-Hochberg adjusted p-values and reject decisions across metrics or arms, returned in input order.","tags":["experimentation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"pValues":{"minItems":1,"maxItems":10000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":64},"p":{"type":"number","minimum":0,"maximum":1}},"required":["id","p"],"additionalProperties":false}},"methods":{"default":["bonferroni","holm","benjamini_hochberg"],"minItems":1,"maxItems":3,"type":"array","items":{"type":"string","enum":["bonferroni","holm","benjamini_hochberg"]}},"alpha":{"default":0.05,"type":"number","exclusiveMinimum":0,"exclusiveMaximum":0.5}},"required":["pValues"],"additionalProperties":false},"example":{"pValues":[{"id":"m1","p":0.01},{"id":"m2","p":0.04},{"id":"m3","p":0.03},{"id":"m4","p":0.005}],"methods":["bonferroni","holm","benjamini_hochberg"],"alpha":0.05}}}},"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":{"id":{"type":"string"},"p":{"type":"number"},"bonferroni":{"type":"number"},"holm":{"type":"number"},"benjamini_hochberg":{"type":"number"},"rejected":{"type":"object","properties":{"bonferroni":{"type":"boolean"},"holm":{"type":"boolean"},"benjamini_hochberg":{"type":"boolean"}},"additionalProperties":true}},"additionalProperties":true}},"alpha":{"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":{"results":[{"id":"m1","p":0.01,"bonferroni":0.04,"holm":0.03,"benjamini_hochberg":0.02,"rejected":{"bonferroni":true,"holm":true,"benjamini_hochberg":true}},{"id":"m2","p":0.04,"bonferroni":0.16,"holm":0.06,"benjamini_hochberg":0.04,"rejected":{"bonferroni":false,"holm":false,"benjamini_hochberg":true}},"…"],"alpha":0.05,"sources":[{"source":"Holm (1979) A simple sequentially rejective multiple test procedure","url":"https://www.jstor.org/stable/4615733","retrievedAt":"2026-11-14T00:00:00.000Z","status":"ok"},{"source":"Benjamini & Hochberg (1995) Controlling the false discovery rate","url":"https://doi.org/10.1111/j.2517-6161.1995.tb02031.x","retrievedAt":"2026-11-14T00:00:00.000Z","status":"ok"}],"limitations":["Bonferroni and Holm control the family-wise error rate; Benjamini-Hochberg controls the false discovery rate and assume…","Pure computation on the supplied input: no events are stored and no network is called. Results are statistical calculat…"]}}}},"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"}}},"/api/v1/experimentation/delta-method-ratio":{"post":{"operationId":"estimate_a_ratio_metric_with_the_delta_method","summary":"Estimate a ratio metric with the delta method","description":"Confidence interval for a ratio metric whose analysis unit differs from the randomisation unit, plus the treatment-vs-control difference and relative lift. Accepts unit rows or aggregates.","tags":["experimentation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"arms":{"minItems":1,"maxItems":2,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":64},"control":{"type":"boolean"},"units":{"minItems":2,"maxItems":1000000,"type":"array","items":{"type":"object","properties":{"num":{"type":"number"},"den":{"type":"number","minimum":0}},"required":["num","den"],"additionalProperties":false}},"n":{"type":"integer","minimum":2,"maximum":9007199254740991},"sumNum":{"type":"number"},"sumDen":{"type":"number","minimum":0},"sumNum2":{"type":"number","minimum":0},"sumDen2":{"type":"number","minimum":0},"sumNumDen":{"type":"number"}},"required":["name"],"additionalProperties":false}},"alpha":{"default":0.05,"type":"number","exclusiveMinimum":0,"exclusiveMaximum":0.5}},"required":["arms"],"additionalProperties":false},"example":{"arms":[{"name":"control","units":[{"num":10,"den":2},{"num":0,"den":1},{"num":5,"den":1},{"num":20,"den":4},{"num":3,"den":1},{"num":0,"den":2},{"num":8,"den":2},{"num":12,"den":3}]}],"alpha":0.05}}}},"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":{"arms":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"ratio":{"type":"number"},"se":{"type":"number"},"ci":{"type":"array","items":{"type":"number"}}},"additionalProperties":true}},"difference":{"type":"object","properties":{"estimate":{"type":"null"},"se":{"type":"null"},"ci":{"type":"null"},"pValue":{"type":"null"}},"additionalProperties":true},"relativeLift":{"type":"null"},"relativeCi":{"type":"null"},"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":{"arms":[{"name":"control","ratio":3.625,"se":0.6931585317,"ci":[2.266434242,4.983565758]}],"difference":{"estimate":null,"se":null,"ci":null,"pValue":null},"relativeLift":null,"relativeCi":null,"sources":[{"source":"Deng, Knoblich, Lu (2018) Applying the Delta Method in Metric Analytics","url":"https://arxiv.org/abs/1803.06336","retrievedAt":"2026-11-14T00:00:00.000Z","status":"ok"}],"limitations":["First-order delta method with a normal quantile; it is accurate for large numbers of randomisation units and unreliable…","Pure computation on the supplied input: no events are stored and no network is called. Results are statistical calculat…"]}}}},"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/experimentation/bandit-allocate":{"post":{"operationId":"compute_multi_armed_bandit_traffic_weights","summary":"Compute multi-armed bandit traffic weights","description":"Next-period traffic weights from arm outcomes: Thompson-sampling probabilities by deterministic quadrature, or UCB1 indices, with an exploration floor.","tags":["experimentation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"policy":{"type":"string","enum":["thompson","ucb1"]},"arms":{"minItems":2,"maxItems":20,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":64},"successes":{"type":"integer","minimum":0,"maximum":9007199254740991},"failures":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["name","successes","failures"],"additionalProperties":false}},"prior":{"default":{"alpha":1,"beta":1},"type":"object","properties":{"alpha":{"default":1,"type":"number","exclusiveMinimum":0},"beta":{"default":1,"type":"number","exclusiveMinimum":0}},"additionalProperties":false},"minShare":{"default":0,"type":"number","minimum":0,"maximum":0.5}},"required":["policy","arms"],"additionalProperties":false},"example":{"policy":"thompson","arms":[{"name":"A","successes":100,"failures":900},{"name":"B","successes":120,"failures":880},{"name":"C","successes":90,"failures":910}],"prior":{"alpha":1,"beta":1},"minShare":0.05}}}},"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":{"policy":{"type":"string"},"weights":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"probBest":{"type":"number"},"weight":{"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":{"policy":"thompson","weights":[{"name":"A","probBest":0.07474923213,"weight":0.07176986341},{"name":"B","probBest":0.9146879375,"weight":0.8782301366},"…"],"sources":[{"source":"Russo et al. (2018) A Tutorial on Thompson Sampling","url":"https://arxiv.org/abs/1707.02038","retrievedAt":"2026-11-14T00:00:00.000Z","status":"ok"},{"source":"Miller (2015) Formulas for Bayesian A/B Testing","url":"https://www.evanmiller.org/bayesian-ab-testing.html","retrievedAt":"2026-11-14T00:00:00.000Z","status":"ok"}],"limitations":["Thompson weights are exact posterior probabilities of being best (quadrature), not random draws, so repeated calls retu…","Pure computation on the supplied input: no events are stored and no network is called. Results are statistical calculat…"]}}}},"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/experimentation/bucket-assign":{"post":{"operationId":"assign_units_to_experiment_groups_deterministically","summary":"Assign units to experiment groups deterministically","description":"Stateless SHA-256 bucketing of unit ids into an experiment with traffic gating, ordered group shares and an optional layer, documented so any SDK can reproduce it.","tags":["experimentation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"unitIds":{"minItems":1,"maxItems":10000,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}},"experiment":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":128},"salt":{"type":"string","minLength":1,"maxLength":128},"trafficShare":{"default":1,"type":"number","exclusiveMinimum":0,"maximum":1},"groups":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":64},"share":{"type":"number","exclusiveMinimum":0,"maximum":1}},"required":["name","share"],"additionalProperties":false}}},"required":["salt","groups"],"additionalProperties":false},"layer":{"anyOf":[{"type":"object","properties":{"salt":{"type":"string","minLength":1,"maxLength":128},"segments":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"experiment":{"type":"string","minLength":1,"maxLength":128},"from":{"type":"integer","minimum":0,"maximum":9999},"to":{"type":"integer","minimum":1,"maximum":10000}},"required":["experiment","from","to"],"additionalProperties":false}}},"required":["salt","segments"],"additionalProperties":false},{"type":"null"}]}},"required":["unitIds","experiment"],"additionalProperties":false},"example":{"unitIds":["user_42","user_43"],"experiment":{"salt":"exp_checkout_v2","trafficShare":1,"groups":[{"name":"control","share":0.5},{"name":"treatment","share":0.5}]},"layer":null}}}},"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":{"assignments":{"type":"array","items":{"type":"object","properties":{"unitId":{"type":"string"},"bucket":{"type":"number"},"groupBucket":{"type":"number"},"inExperiment":{"type":"boolean"},"group":{"type":"string"}},"additionalProperties":true}},"algorithm":{"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":{"assignments":[{"unitId":"user_42","bucket":7765,"groupBucket":8754,"inExperiment":true,"group":"treatment"},{"unitId":"user_43","bucket":1211,"groupBucket":9800,"inExperiment":true,"group":"treatment"}],"algorithm":"sha256(salt + '.' + unitId), first 8 bytes big-endian uint64 mod 10000","sources":[{"source":"NIST FIPS 180-4 Secure Hash Standard (SHA-256)","url":"https://csrc.nist.gov/pubs/fips/180-4/upd1/final","retrievedAt":"2026-11-14T00:00:00.000Z","status":"ok"}],"limitations":["Group assignment hashes salt + '.group.' + unitId so changing trafficShare does not reshuffle groups. Changing a salt r…","Pure computation on the supplied input: no events are stored and no network is called. Results are statistical calculat…"]}}}},"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"}}},"/api/v1/experimentation/flag-rule-evaluate":{"post":{"operationId":"evaluate_a_feature_flag_rule_set","summary":"Evaluate a feature-flag rule set","description":"Evaluate ordered feature-flag rules (attribute operators, semver comparison, deterministic percentage rollout) for one user context and explain which rule matched.","tags":["experimentation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"flag":{"type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":128},"salt":{"type":"string","minLength":1,"maxLength":128},"default":{"type":["string","number","boolean"]},"rules":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":64},"conditions":{"default":[],"maxItems":20,"type":"array","items":{"type":"object","properties":{"attribute":{"type":"string","minLength":1,"maxLength":128},"op":{"type":"string","enum":["eq","neq","in","not_in","contains","starts_with","ends_with","regex","gt","gte","lt","lte","semver_gt","semver_gte","semver_lt","semver_lte","exists"]},"value":{"anyOf":[{"type":["string","number","boolean"]},{"maxItems":1000,"type":"array","items":{"type":["string","number"]}}]}},"required":["attribute","op"],"additionalProperties":false}},"rollout":{"type":"number","minimum":0,"maximum":1},"serve":{"type":["string","number","boolean"]}},"required":["id","serve"],"additionalProperties":false}}},"required":["key","salt","default","rules"],"additionalProperties":false},"context":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"maxItems":1000,"type":"array","items":{"type":["string","number"]}}]}}},"required":["flag","context"],"additionalProperties":false},"example":{"flag":{"key":"new_checkout","salt":"new_checkout","default":false,"rules":[{"id":"staff","conditions":[{"attribute":"email","op":"ends_with","value":"@acme.com"}],"serve":true},{"id":"uk_rollout","conditions":[{"attribute":"country","op":"in","value":["GB"]}],"rollout":0.25,"serve":true}]},"context":{"userId":"user_42","email":"a@b.com","country":"GB","appVersion":"5.2.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":{"value":{"type":"boolean"},"matchedRule":{"type":"null"},"trace":{"type":"array","items":{"type":"object","properties":{"rule":{"type":"string"},"matched":{"type":"boolean"},"failedCondition":{"type":"number"},"inRollout":{"type":"boolean"},"bucket":{"type":"number"}},"additionalProperties":true}},"reason":{"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":{"value":false,"matchedRule":null,"trace":[{"rule":"staff","matched":false,"failedCondition":0},{"rule":"uk_rollout","matched":true,"inRollout":false,"bucket":3933}],"reason":"default","sources":[{"source":"NIST FIPS 180-4 Secure Hash Standard (SHA-256)","url":"https://csrc.nist.gov/pubs/fips/180-4/upd1/final","retrievedAt":"2026-11-14T00:00:00.000Z","status":"ok"},{"source":"Semantic Versioning 2.0.0","url":"https://semver.org/","retrievedAt":"2026-11-14T00:00:00.000Z","status":"ok"}],"limitations":["Regex conditions run on the JavaScript engine with a guard (no backreferences, lookaround or nested quantifiers, 200 ch…","Pure computation on the supplied input: no events are stored and no network is called. Results are statistical calculat…"]}}}},"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"}}},"/api/v1/experimentation/novelty-effect-detect":{"post":{"operationId":"detect_novelty_or_primacy_effects_in_daily_lift","summary":"Detect novelty or primacy effects in daily lift","description":"OLS trend test on daily lift with early-versus-late means, classifying the pattern as novelty, primacy or stable.","tags":["experimentation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"daily":{"minItems":6,"maxItems":365,"type":"array","items":{"type":"object","properties":{"day":{"type":"number"},"lift":{"type":"number"}},"required":["day","lift"],"additionalProperties":false}},"liftType":{"type":"string","enum":["relative","absolute"]},"earlyDays":{"type":"integer","minimum":1,"maximum":9007199254740991},"alpha":{"default":0.05,"type":"number","exclusiveMinimum":0,"exclusiveMaximum":0.5}},"required":["daily"],"additionalProperties":false},"example":{"daily":[{"day":1,"lift":0.12},{"day":2,"lift":0.1},{"day":3,"lift":0.09},{"day":4,"lift":0.07},{"day":5,"lift":0.06},{"day":6,"lift":0.05},{"day":7,"lift":0.05},{"day":8,"lift":0.04},{"day":9,"lift":0.04},{"day":10,"lift":0.04},{"day":11,"lift":0.03},{"day":12,"lift":0.04},{"day":13,"lift":0.03},{"day":14,"lift":0.03}],"liftType":"relative","earlyDays":7,"alpha":0.05}}}},"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":{"slopePerDay":{"type":"number"},"slopeSe":{"type":"number"},"t":{"type":"number"},"pValue":{"type":"number"},"earlyMean":{"type":"number"},"lateMean":{"type":"number"},"earlyDays":{"type":"number"},"liftType":{"type":"string"},"pattern":{"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":{"slopePerDay":-0.006175824176,"slopeSe":0.000821950598,"t":-7.513619664,"pValue":0.000007103095267,"earlyMean":0.07714285714,"lateMean":0.03571428571,"earlyDays":7,"liftType":"relative","pattern":"novelty","sources":[{"source":"NIST/SEMATECH e-Handbook: linear least squares regression","url":"https://www.itl.nist.gov/div898/handbook/pmd/section4/pmd431.htm","retrievedAt":"2026-11-14T00:00:00.000Z","status":"ok"}],"limitations":["A straight-line trend is a coarse model: weekly seasonality, holidays and campaigns can mimic or hide a novelty effect.…","Pure computation on the supplied input: no events are stored and no network is called. Results are statistical calculat…"]}}}},"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"}}},"/api/v1/experimentation/segment-lift":{"post":{"operationId":"measure_a_b_lift_per_segment_with_fdr_control","summary":"Measure A/B lift per segment with FDR control","description":"Per-segment conversion lift with Benjamini-Hochberg adjusted p-values, a Cochran Q heterogeneity test and suppression of small segments.","tags":["experimentation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"segments":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":64},"control":{"type":"object","properties":{"users":{"type":"integer","minimum":1,"maximum":9007199254740991},"conversions":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["users","conversions"],"additionalProperties":false},"treatment":{"type":"object","properties":{"users":{"type":"integer","minimum":1,"maximum":9007199254740991},"conversions":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["users","conversions"],"additionalProperties":false}},"required":["name","control","treatment"],"additionalProperties":false}},"minUsersPerArm":{"default":100,"type":"integer","minimum":0,"maximum":9007199254740991},"alpha":{"default":0.05,"type":"number","exclusiveMinimum":0,"exclusiveMaximum":0.5}},"required":["segments"],"additionalProperties":false},"example":{"segments":[{"name":"mobile","control":{"users":5000,"conversions":500},"treatment":{"users":5000,"conversions":600}},{"name":"desktop","control":{"users":4000,"conversions":480},"treatment":{"users":4000,"conversions":484}},{"name":"tablet","control":{"users":1000,"conversions":100},"treatment":{"users":1000,"conversions":110}}],"minUsersPerArm":100,"alpha":0.05}}}},"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":{"segments":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"absoluteLift":{"type":"number"},"ci":{"type":"array","items":{"type":"number"}},"z":{"type":"number"},"pValue":{"type":"number"},"pAdjustedBH":{"type":"number"},"significant":{"type":"boolean"}},"additionalProperties":true}},"heterogeneity":{"type":"object","properties":{"pooledLift":{"type":"number"},"Q":{"type":"number"},"df":{"type":"number"},"pValue":{"type":"number"},"I2":{"type":"number"}},"additionalProperties":true},"suppressed":{"type":"array","items":{}},"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":{"segments":[{"name":"mobile","absoluteLift":0.02,"ci":[0.007741212578,0.03225878742],"z":3.197647397,"pValue":0.001385535823,"pAdjustedBH":0.004156607469,"significant":true},{"name":"desktop","absoluteLift":0.001,"ci":[-0.01326737336,0.01526737336],"z":0.1373738484,"pValue":0.890735301,"pAdjustedBH":0.890735301,"significant":false},"…"],"heterogeneity":{"pooledLift":0.01172400678,"Q":3.936950198,"df":2,"pValue":0.1396696763,"I2":0.4919925579},"suppressed":[],"sources":[{"source":"Benjamini & Hochberg (1995) Controlling the false discovery rate","url":"https://doi.org/10.1111/j.2517-6161.1995.tb02031.x","retrievedAt":"2026-11-14T00:00:00.000Z","status":"ok"},{"source":"Higgins & Thompson (2002) Quantifying heterogeneity in a meta-analysis","url":"https://doi.org/10.1002/sim.1186","retrievedAt":"2026-11-14T00:00:00.000Z","status":"ok"}],"limitations":["Segments are only as valid as randomisation within each segment; segments chosen after seeing results inflate false pos…","Heterogeneity uses inverse-variance weights on absolute lift.","…"]}}}},"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/experimentation/guardrail-check":{"post":{"operationId":"check_a_b_guardrail_metrics_for_non_inferiority","summary":"Check A/B guardrail metrics for non-inferiority","description":"One-sided non-inferiority tests of guardrail metrics against caller-supplied relative or absolute margins, with bounds and an overall pass flag.","tags":["experimentation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"alpha":{"default":0.05,"type":"number","exclusiveMinimum":0,"exclusiveMaximum":0.5},"metrics":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":64},"type":{"type":"string","enum":["mean","proportion"]},"higherIsBetter":{"default":true,"type":"boolean"},"marginType":{"type":"string","enum":["relative","absolute"]},"margin":{"type":"number","exclusiveMinimum":0},"control":{"anyOf":[{"type":"object","properties":{"users":{"type":"integer","minimum":1,"maximum":9007199254740991},"conversions":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["users","conversions"],"additionalProperties":false},{"type":"object","properties":{"n":{"type":"integer","minimum":2,"maximum":9007199254740991},"mean":{"type":"number"},"sd":{"type":"number","minimum":0}},"required":["n","mean","sd"],"additionalProperties":false}]},"treatment":{"anyOf":[{"type":"object","properties":{"users":{"type":"integer","minimum":1,"maximum":9007199254740991},"conversions":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["users","conversions"],"additionalProperties":false},{"type":"object","properties":{"n":{"type":"integer","minimum":2,"maximum":9007199254740991},"mean":{"type":"number"},"sd":{"type":"number","minimum":0}},"required":["n","mean","sd"],"additionalProperties":false}]}},"required":["name","type","marginType","margin","control","treatment"],"additionalProperties":false}}},"required":["metrics"],"additionalProperties":false},"example":{"alpha":0.05,"metrics":[{"name":"latency_ms","type":"mean","higherIsBetter":false,"marginType":"relative","margin":0.02,"control":{"n":5000,"mean":200,"sd":80},"treatment":{"n":5000,"mean":201.5,"sd":82}}]}}}},"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":{"metrics":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"difference":{"type":"number"},"se":{"type":"number"},"margin":{"type":"number"},"z":{"type":"number"},"pValue":{"type":"number"},"upperBound":{"type":"number"},"pass":{"type":"boolean"}},"additionalProperties":true}},"allPass":{"type":"boolean"},"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":{"metrics":[{"name":"latency_ms","difference":1.5,"se":1.620123452,"margin":4,"z":1.543092285,"pValue":0.06140419316,"upperBound":4.164865936,"pass":false}],"allPass":false,"sources":[{"source":"Walker & Nowacki (2011) Understanding equivalence and noninferiority testing","url":"https://doi.org/10.1007/s11606-010-1513-8","retrievedAt":"2026-11-14T00:00:00.000Z","status":"ok"}],"limitations":["One-sided non-inferiority z-test at the caller's alpha with an unpooled standard error; the margin is the caller's busi…","Failing to show non-inferiority is not evidence of harm, and passing does not show no change.","…"]}}}},"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/experimentation/holdout-impact":{"post":{"operationId":"measure_cumulative_impact_against_a_long_term_holdout","summary":"Measure cumulative impact against a long-term holdout","description":"Exposed-versus-holdout impact with confidence interval and p-value, plus diluted population-level impact for partial exposure.","tags":["experimentation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"metricType":{"type":"string","enum":["proportion","mean"]},"holdout":{"anyOf":[{"type":"object","properties":{"users":{"type":"integer","minimum":1,"maximum":9007199254740991},"conversions":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["users","conversions"],"additionalProperties":false},{"type":"object","properties":{"n":{"type":"integer","minimum":2,"maximum":9007199254740991},"mean":{"type":"number"},"sd":{"type":"number","minimum":0}},"required":["n","mean","sd"],"additionalProperties":false}]},"exposed":{"anyOf":[{"type":"object","properties":{"users":{"type":"integer","minimum":1,"maximum":9007199254740991},"conversions":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["users","conversions"],"additionalProperties":false},{"type":"object","properties":{"n":{"type":"integer","minimum":2,"maximum":9007199254740991},"mean":{"type":"number"},"sd":{"type":"number","minimum":0}},"required":["n","mean","sd"],"additionalProperties":false}]},"exposureRate":{"type":"number","exclusiveMinimum":0,"maximum":1},"alpha":{"default":0.05,"type":"number","exclusiveMinimum":0,"exclusiveMaximum":0.5}},"required":["metricType","holdout","exposed"],"additionalProperties":false},"example":{"metricType":"proportion","holdout":{"users":20000,"conversions":2000},"exposed":{"users":180000,"conversions":18720},"exposureRate":0.6,"alpha":0.05}}}},"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":{"absoluteImpact":{"type":"number"},"ci":{"type":"array","items":{"type":"number"}},"relativeImpact":{"type":"number"},"pValue":{"type":"number"},"dilutedImpact":{"type":"number"},"dilutedCi":{"type":"array","items":{"type":"number"}},"significant":{"type":"boolean"},"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":{"absoluteImpact":0.004,"ci":[-0.0003903582134,0.008390358213],"relativeImpact":0.04,"pValue":0.07414809347,"dilutedImpact":0.0024,"dilutedCi":[-0.000234214928,0.005034214928],"significant":false,"sources":[{"source":"NIST/SEMATECH e-Handbook: two-sample t-test (Welch)","url":"https://www.itl.nist.gov/div898/handbook/eda/section3/eda353.htm","retrievedAt":"2026-11-14T00:00:00.000Z","status":"ok"}],"limitations":["Diluted impact scales the exposed-vs-holdout difference by exposureRate (intent-to-treat style); it assumes the unexpos…","Pure computation on the supplied input: no events are stored and no network is called. Results are statistical calculat…"]}}}},"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":{}}}}}}}}