---
title: "X402 Gauntlet"
method: POST
path: "/x402/v1/gauntlet"
---

# X402 Gauntlet

`POST /x402/v1/gauntlet`

## Request

- Base URL: `https://api.alphaassay.com`
- URL: `https://api.alphaassay.com/x402/v1/gauntlet`
- Auth: none declared

Hold one shared fence across verify, settle, resolution, and execution.

## Headers

- `X-PAYMENT` string

## Request body

- GauntletRequest
  - `spec` DslSpec, required
    - `dsl_version` string, required
    - `asset_universe` string[], required
    - `bar_interval` string, required
    - `target` object, required
    - `signal` object, required
    - `position` object, nullable
    - `entry_lag_bars` integer, nullable
  - `ohlcv_by_symbol` object, required
  - `adv_by_symbol_usd` object, nullable
  - `sigma_by_symbol_pct` object, nullable
  - `funding_by_symbol` object, nullable
  - `sketch_opt_out` boolean
  - `fee_bps_per_side` number
  - `variants_in_call` integer
  - `n_placebos` integer

## Response `200`

Successful Response

- union
  - X402GauntletSuccess
    - `_meta` PublicMeta, required
      - `engine_version` string, required
      - `api_version` string, required
      - `as_of` string, date-time, required
      - `input_digest` string, required
      - `request_digest` string, required
      - `tenant_scope` string, required
      - `tenant_scope_version` string, required
      - `request_id` string, nullable, required
      - `source_identity_digest` string, required
      - `operation` string, required
      - `statefulness` 'pure' | 'public_read' | 'tenant_read' | 'tenant_write', required
      - `not_financial_advice` true, required
      - `disclaimer` string, required
    - `schema` 'gauntlet.v1', required
    - `verdict` 'pass' | 'conditional' | 'fail', required
    - `budget` GauntletBudget, required
      - `cumulative_n` integer, nullable, required
      - `n_trials_effective` integer, nullable, required
      - `effective_n_method` string, nullable, required
      - `break_even_n` integer, nullable, required
      - `family_threshold_sharpe_per_obs` union, required
        - integer
        - number
      - `sketch_retained` boolean, nullable
      - `sketch_note` string, nullable
      - `note` string, required
    - `stages` union[], required
      - union
        - NetEdgeStage
          - `stage` 'net_edge', required
          - `verdict` 'pass' | 'fail', required
          - `evidence` NetEdgeEvidence, required
            - `net_sharpe_annualized` union, required
              - …
            - `net_return_total_pct` union, required
              - …
            - `trades` integer, required
            - `bars` integer, required
          - `detail` string, required
        - FundingEdgeStage
          - `stage` 'funding_edge', required
          - `verdict` 'pass' | 'fail' | 'warn' | 'skipped', required
          - `evidence` union, required
            - FundingEvidence
              - …
            - EmptyObject: An explicitly empty, closed object.
          - `detail` string, required
        - FamilyDeflationStage
          - `stage` 'family_deflation', required
          - `verdict` 'pass' | 'fail', required
          - `evidence` FamilyDeflationEvidence, required
            - `dsr` union, required
              - …
            - `cumulative_n` integer, nullable, required
            - `n_trials_effective` integer, nullable, required
            - `variants_in_call` integer, nullable, required
            - `family_verdict` 'survives' | 'deflated_out', nullable, required
            - `effective_n_method` string, nullable, required
            - `killed_by` string[], nullable, required
          - `detail` string, required
        - PowerHonestyStage
          - `stage` 'power_honesty', required
          - `verdict` 'pass' | 'fail' | 'info', required
          - `evidence` PowerHonestyEvidence, required
            - `min_btl_obs` integer, nullable, required
            - `bars` integer, required
            - `n_trials_effective` integer, required
            - `achieved_power` union, required
              - …
            - `cohens_d` union, required
              - …
            - `n_required_80` integer, nullable, required
            - `underpowered` boolean, required
          - `detail` string, required
        - SignificanceStage
          - `stage` 'significance', required
          - `verdict` 'pass' | 'info' | 'skipped', required
          - `evidence` SignificanceEvidence, required
            - `bootstrap_ci` ConfidenceInterval, required
              - …
            - `studentized_ci` StudentizedInterval, required
              - …
            - `hac` HacEvidence, required
              - …
            - `permutation` PermutationEvidence, required
              - …
            - `binomial` BinomialEvidence, required
              - …
            - `normality` NormalityEvidence, required
              - …
            - `flags` string[], required
            - `advisories` string[], required
          - `detail` string, required
        - CpcvStage
          - `stage` 'cpcv', required
          - `verdict` 'pass' | 'fail' | 'skipped', required
          - `evidence` union, required
            - CpcvComputedEvidence
              - …
            - InsufficientStageEvidence
              - …
          - `detail` string, required
        - WalkForwardStage
          - `stage` 'walk_forward', required
          - `verdict` 'pass' | 'fail' | 'info' | 'skipped', required
          - `evidence` union, required
            - WalkForwardEvidence
              - …
            - InsufficientStageEvidence
              - …
          - `detail` string, required
        - ConcentrationStage
          - `stage` 'concentration', required
          - `verdict` 'pass' | 'fail' | 'warn' | 'info', required
          - `evidence` ConcentrationEvidence, required
            - `top_1pct_share` union, required
              - …
            - `n_top_bars` integer, nullable, required
            - `rest_net_return_total_pct` union, required
              - …
            - `warn_share_threshold` union, required
              - …
          - `detail` string, required
        - PlaceboStage
          - `stage` 'placebo', required
          - `verdict` 'pass' | 'fail' | 'warn' | 'skipped', required
          - `evidence` PlaceboEvidence, required
            - `percentile` union, required
              - …
            - `n_placebos_effective` integer, nullable, required
            - `basis` 'per_trade_gross', required
            - `sign_shuffle_percentile` union, required
              - …
            - `chronology_percentile` union, required
              - …
            - `real_trade_sharpe_annualized` union, required
              - …
          - `detail` string, required
        - CapacityStage
          - `stage` 'capacity', required
          - `verdict` 'pass' | 'fail' | 'skipped', required
          - `evidence` union, required
            - CapacityEvidence
              - …
            - EmptyObject: An explicitly empty, closed object.
          - `detail` string, required
        - GraveyardPriorStage
          - `stage` 'graveyard_prior', required
          - `verdict` 'info', required
          - `evidence` GraveyardPriorEvidence, required
            - `family_published` boolean, required
            - `prior_kill_rate` union, required
              - …
            - `top_kill_reasons` KillReason[], nullable, required
              - …
          - `detail` string, required
    - `failure_codes` string[], required
    - `family_id` string, required
    - `spec_hash` string, required
    - `data_note` string, nullable
    - `disclaimer` string, required
    - `died_at` string, nullable, required
    - `died_at_plain` string, nullable, required
    - `wallet_trust` X402WalletTrust, required
      - `settles_seen` integer, required
      - `sybil_prior_trials` integer, required
      - `tenant_scope_version` string, required
      - `source_identity_digest` string, required
      - `note` string, required
    - `receipt` union, required
      - SignedX402Receipt
        - `signed` true, required
        - `receipt` X402ReceiptPayload, required
          - `schema` 'x402_receipt.v1', required
          - `payment` X402PaymentReceipt, required
            - `nonce` string, nullable, required
            - `transaction` string, nullable, required
            - `network` string, nullable, required
            - `payer` string, required
          - `input_digest` string, required
          - `verdict_digest` string, required
          - `engine_version` string, nullable, required
          - `issued_at` string, required
        - `signature_b64` string, required
        - `public_key_id` string, required
        - `verify_hint` string, required
      - UnsignedX402Receipt
        - `signed` false, required
        - `receipt` X402ReceiptPayload, required
          - `schema` 'x402_receipt.v1', required
          - `payment` X402PaymentReceipt, required
            - `nonce` string, nullable, required
            - `transaction` string, nullable, required
            - `network` string, nullable, required
            - `payer` string, required
          - `input_digest` string, required
          - `verdict_digest` string, required
          - `engine_version` string, nullable, required
          - `issued_at` string, required
        - `note` string, required
    - `replayed` boolean, nullable
  - X402SettledGauntletError: Commit-priced semantic rejection returned with its paid receipt.
    - `error` string, required
    - `code` 'invalid_input', required
    - `_meta` PublicMeta, required
      - `engine_version` string, required
      - `api_version` string, required
      - `as_of` string, date-time, required
      - `input_digest` string, required
      - `request_digest` string, required
      - `tenant_scope` string, required
      - `tenant_scope_version` string, required
      - `request_id` string, nullable, required
      - `source_identity_digest` string, required
      - `operation` string, required
      - `statefulness` 'pure' | 'public_read' | 'tenant_read' | 'tenant_write', required
      - `not_financial_advice` true, required
      - `disclaimer` string, required
    - `wallet_trust` X402WalletTrust, required
      - `settles_seen` integer, required
      - `sybil_prior_trials` integer, required
      - `tenant_scope_version` string, required
      - `source_identity_digest` string, required
      - `note` string, required
    - `receipt` union, required
      - SignedX402Receipt
        - `signed` true, required
        - `receipt` X402ReceiptPayload, required
          - `schema` 'x402_receipt.v1', required
          - `payment` X402PaymentReceipt, required
            - `nonce` string, nullable, required
            - `transaction` string, nullable, required
            - `network` string, nullable, required
            - `payer` string, required
          - `input_digest` string, required
          - `verdict_digest` string, required
          - `engine_version` string, nullable, required
          - `issued_at` string, required
        - `signature_b64` string, required
        - `public_key_id` string, required
        - `verify_hint` string, required
      - UnsignedX402Receipt
        - `signed` false, required
        - `receipt` X402ReceiptPayload, required
          - `schema` 'x402_receipt.v1', required
          - `payment` X402PaymentReceipt, required
            - `nonce` string, nullable, required
            - `transaction` string, nullable, required
            - `network` string, nullable, required
            - `payer` string, required
          - `input_digest` string, required
          - `verdict_digest` string, required
          - `engine_version` string, nullable, required
          - `issued_at` string, required
        - `note` string, required
    - `replayed` boolean, nullable

## Other responses

- `402`: Current x402 payment requirements
- `413`: Request could not be completed
- `422`: Request could not be completed
- `429`: Request rate limit exceeded
- `500`: Internal execution failure
- `503`: Request could not be completed

---

[API](https://skmtc.dev/alphaassay/apis/alphaassay-api.md) · [All operations](https://skmtc.dev/alphaassay/apis/alphaassay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/alphaassay/apis/alphaassay-api/revisions/cdbc99b01a7e?raw)