> For the complete documentation index, see [llms.txt](https://lambdaplex-labs.gitbook.io/lambdaplex/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://lambdaplex-labs.gitbook.io/lambdaplex/for-developers/api/vault-hedging.md).

# Vault Hedging

Typed guarded vault execution; V2 API signatures are mandatory

## Close or recover one causally uncertain guarded hedge admission

> \*\*Weight:\*\* 1

```json
{"openapi":"3.1.0","info":{"title":"Lambdaplex API","version":"1.0"},"tags":[{"name":"Vault hedging","description":"Typed guarded vault execution; V2 API signatures are mandatory"}],"servers":[{"url":"https://api.lambdaplex.io","description":"Generated server url"}],"security":[{"XApiKey":[],"Ed25519Sig":[]}],"components":{"securitySchemes":{"XApiKey":{"type":"apiKey","description":"API key identifier. For Ed25519 V2 operations, its exact header value is the second line of the canonical signing payload.","name":"X-API-KEY","in":"header"}},"schemas":{"GuardedHedgeOperation":{"type":"object","properties":{"operationId":{"type":"string","format":"uuid"},"quoteId":{"type":"string","format":"uuid"},"operationVersion":{"type":"string"},"physicalAttempt":{"type":"integer","format":"int32"},"lifecycleState":{"type":"string"},"effectState":{"type":"string"},"settlementState":{"type":"string"},"consensusState":{"type":"string"},"chainId":{"type":"string"},"vault":{"type":"string"},"guard":{"type":"string"},"operator":{"type":"string"},"makerPolicy":{"type":"string"},"hedgeDirection":{"type":"string"},"amountMode":{"type":"string"},"amountIn":{"type":"string"},"amountOutMin":{"type":"string"},"economicObligationId":{"type":"string"},"guardBindingId":{"type":"string"},"guardedHedgeId":{"type":"string"},"stateCommitment":{"type":"string"},"invocationHash":{"type":"string"},"routeHash":{"type":"string"},"observationEvidenceHash":{"type":"string"},"simulationEvidenceHash":{"type":"string"},"transactionId":{"type":"string"},"expectedNativeTransactionHash":{"type":"string"},"expectedEvmTransactionHash":{"type":"string"},"finalStatus":{"type":"string"},"finalConsensusNs":{"type":"string"},"amountOutActual":{"type":"string"},"proof":{"$ref":"#/components/schemas/Proof"},"failure":{"$ref":"#/components/schemas/Failure"},"replacementEligible":{"type":"boolean"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"_links":{"$ref":"#/components/schemas/Links"}}},"Proof":{"type":"object","properties":{"transactionBodyHash":{"type":"string"},"signedTransactionHash":{"type":"string"},"validUntil":{"type":"string"},"submissionAttempts":{"type":"integer","format":"int32"},"precheckCode":{"type":"string"},"precheckAt":{"type":"string"},"finalityEvidenceHash":{"type":"string"},"settlementEvidenceSource":{"type":"string"},"settlementEvidenceVersion":{"type":"string"},"settlementEvidenceHash":{"type":"string"},"noEffectProofKind":{"type":"string"},"noEffectEvidenceHash":{"type":"string"},"accountingProof":{"$ref":"#/components/schemas/GuardedHedgeAccountingProof"},"absenceWatermarkBlock":{"type":"string"},"absenceWatermarkConsensus":{"type":"string"},"absencePagesScanned":{"type":"integer","format":"int32"},"absenceProvedAt":{"type":"string"},"readjudication":{"$ref":"#/components/schemas/Readjudication"}}},"GuardedHedgeAccountingProof":{"type":"object","properties":{"codec":{"type":"string"},"operationId":{"type":"string","format":"uuid"},"quoteId":{"type":"string","format":"uuid"},"chainId":{"type":"string"},"vaultAccountId":{"type":"string"},"baseTokenId":{"type":"string"},"quoteTokenId":{"type":"string"},"baseBalanceBefore":{"type":"string"},"baseBalanceAfter":{"type":"string"},"quoteBalanceBefore":{"type":"string"},"quoteBalanceAfter":{"type":"string"},"amountIn":{"type":"string"},"amountOutMin":{"type":"string"},"amountOutActual":{"type":"string"},"baseMutation":{"$ref":"#/components/schemas/Mutation"},"quoteMutation":{"$ref":"#/components/schemas/Mutation"},"finalConsensusNs":{"type":"string"},"accountingEvidenceSource":{"type":"string"},"accountingEvidenceVersion":{"type":"string"},"accountingAppliedAt":{"type":"string"},"feeAttribution":{"type":"string"},"ownerAttributedNetworkFee":{"type":"string"},"proofHash":{"type":"string"}}},"Mutation":{"type":"object","properties":{"consensusNs":{"type":"string"},"eventId":{"type":"string"},"aggregateId":{"type":"string","format":"uuid"},"eventType":{"type":"string"},"payloadSha256":{"type":"string"}}},"Readjudication":{"type":"object","properties":{"kind":{"type":"string"},"supersededFailureStage":{"type":"string"},"supersededFailureReason":{"type":"string"},"priorVersion":{"type":"string"},"readjudicatedAt":{"type":"string"},"operatorPrincipal":{"type":"string"}}},"Failure":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"Links":{"type":"object","properties":{"self":{"type":"string"}}},"RateLimitError":{"type":"object","description":"Error response returned when a request is rate limited (HTTP 429)","properties":{"code":{"type":"string","description":"Error code indicating rate limiting"},"status":{"type":"integer","format":"int32","description":"HTTP status code"},"scope":{"type":"string","description":"Scope of the rate limit: 'rest' for HTTP endpoints, 'ws' for WebSocket handshake","enum":["rest","ws"]},"bucket":{"type":"string","description":"Bucket that triggered the limit (e.g. 'rest_weight', 'orders', 'ws_handshake')"},"keyType":{"type":"string","description":"Key type that was rate limited: 'ip' or 'api'","enum":["ip","api"]},"retryAfterSec":{"type":"number","format":"double","description":"Seconds until enough tokens are available to retry this request"}},"required":["bucket","code","keyType","retryAfterSec","scope","status"]},"ProblemDetail":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer","format":"int32"},"detail":{"type":"string"},"instance":{"type":"string","format":"uri"},"properties":{"type":"object","additionalProperties":{}}}}},"responses":{"RateLimited":{"description":"Too Many Requests - Rate limit exceeded.","headers":{"X-PLEX-USED-WEIGHT-API":{"description":"Rounded burst capacity minus remaining verified API-key tokens (when authenticated accounting ran)","schema":{}},"Retry-After":{"description":"Whole seconds to wait before retrying (ceiling of the computed delay)","schema":{}},"X-PLEX-ORDER-COUNT":{"description":"Rounded order burst capacity minus remaining verified API-key order tokens (when order accounting ran)","schema":{}},"X-PLEX-USED-WEIGHT-IP":{"description":"Rounded burst capacity minus remaining IP tokens; on rejection, describes the rejecting bucket","schema":{}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}},"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}}}},"paths":{"/api/v1/vaults/{numericVaultId}/hedges/{operationId}/admission-resolution":{"put":{"tags":["Vault hedging"],"summary":"Close or recover one causally uncertain guarded hedge admission","description":"**Weight:** 1","operationId":"resolveGuardedHedgeAdmission","parameters":[{"name":"numericVaultId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"operationId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuardedHedgeOperation"}}}},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"description":"Service Unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}}}}
```

## Create a durable guarded hedge operation from one exact quote

> Consumes only the exact opaque quote identity. No approved amount, route, state, deadline, target,\
> manager, signer, or calldata may be replaced. A 202 response means durable intent admission, not\
> consensus or settlement; poll the returned operation link.\
> \
> \
> \*\*Weight:\*\* 1

```json
{"openapi":"3.1.0","info":{"title":"Lambdaplex API","version":"1.0"},"tags":[{"name":"Vault hedging","description":"Typed guarded vault execution; V2 API signatures are mandatory"}],"servers":[{"url":"https://api.lambdaplex.io","description":"Generated server url"}],"security":[{"XApiKey":[],"Ed25519Sig":[]}],"components":{"securitySchemes":{"XApiKey":{"type":"apiKey","description":"API key identifier. For Ed25519 V2 operations, its exact header value is the second line of the canonical signing payload.","name":"X-API-KEY","in":"header"}},"schemas":{"GuardedHedgeOperation":{"type":"object","properties":{"operationId":{"type":"string","format":"uuid"},"quoteId":{"type":"string","format":"uuid"},"operationVersion":{"type":"string"},"physicalAttempt":{"type":"integer","format":"int32"},"lifecycleState":{"type":"string"},"effectState":{"type":"string"},"settlementState":{"type":"string"},"consensusState":{"type":"string"},"chainId":{"type":"string"},"vault":{"type":"string"},"guard":{"type":"string"},"operator":{"type":"string"},"makerPolicy":{"type":"string"},"hedgeDirection":{"type":"string"},"amountMode":{"type":"string"},"amountIn":{"type":"string"},"amountOutMin":{"type":"string"},"economicObligationId":{"type":"string"},"guardBindingId":{"type":"string"},"guardedHedgeId":{"type":"string"},"stateCommitment":{"type":"string"},"invocationHash":{"type":"string"},"routeHash":{"type":"string"},"observationEvidenceHash":{"type":"string"},"simulationEvidenceHash":{"type":"string"},"transactionId":{"type":"string"},"expectedNativeTransactionHash":{"type":"string"},"expectedEvmTransactionHash":{"type":"string"},"finalStatus":{"type":"string"},"finalConsensusNs":{"type":"string"},"amountOutActual":{"type":"string"},"proof":{"$ref":"#/components/schemas/Proof"},"failure":{"$ref":"#/components/schemas/Failure"},"replacementEligible":{"type":"boolean"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"_links":{"$ref":"#/components/schemas/Links"}}},"Proof":{"type":"object","properties":{"transactionBodyHash":{"type":"string"},"signedTransactionHash":{"type":"string"},"validUntil":{"type":"string"},"submissionAttempts":{"type":"integer","format":"int32"},"precheckCode":{"type":"string"},"precheckAt":{"type":"string"},"finalityEvidenceHash":{"type":"string"},"settlementEvidenceSource":{"type":"string"},"settlementEvidenceVersion":{"type":"string"},"settlementEvidenceHash":{"type":"string"},"noEffectProofKind":{"type":"string"},"noEffectEvidenceHash":{"type":"string"},"accountingProof":{"$ref":"#/components/schemas/GuardedHedgeAccountingProof"},"absenceWatermarkBlock":{"type":"string"},"absenceWatermarkConsensus":{"type":"string"},"absencePagesScanned":{"type":"integer","format":"int32"},"absenceProvedAt":{"type":"string"},"readjudication":{"$ref":"#/components/schemas/Readjudication"}}},"GuardedHedgeAccountingProof":{"type":"object","properties":{"codec":{"type":"string"},"operationId":{"type":"string","format":"uuid"},"quoteId":{"type":"string","format":"uuid"},"chainId":{"type":"string"},"vaultAccountId":{"type":"string"},"baseTokenId":{"type":"string"},"quoteTokenId":{"type":"string"},"baseBalanceBefore":{"type":"string"},"baseBalanceAfter":{"type":"string"},"quoteBalanceBefore":{"type":"string"},"quoteBalanceAfter":{"type":"string"},"amountIn":{"type":"string"},"amountOutMin":{"type":"string"},"amountOutActual":{"type":"string"},"baseMutation":{"$ref":"#/components/schemas/Mutation"},"quoteMutation":{"$ref":"#/components/schemas/Mutation"},"finalConsensusNs":{"type":"string"},"accountingEvidenceSource":{"type":"string"},"accountingEvidenceVersion":{"type":"string"},"accountingAppliedAt":{"type":"string"},"feeAttribution":{"type":"string"},"ownerAttributedNetworkFee":{"type":"string"},"proofHash":{"type":"string"}}},"Mutation":{"type":"object","properties":{"consensusNs":{"type":"string"},"eventId":{"type":"string"},"aggregateId":{"type":"string","format":"uuid"},"eventType":{"type":"string"},"payloadSha256":{"type":"string"}}},"Readjudication":{"type":"object","properties":{"kind":{"type":"string"},"supersededFailureStage":{"type":"string"},"supersededFailureReason":{"type":"string"},"priorVersion":{"type":"string"},"readjudicatedAt":{"type":"string"},"operatorPrincipal":{"type":"string"}}},"Failure":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"Links":{"type":"object","properties":{"self":{"type":"string"}}},"RateLimitError":{"type":"object","description":"Error response returned when a request is rate limited (HTTP 429)","properties":{"code":{"type":"string","description":"Error code indicating rate limiting"},"status":{"type":"integer","format":"int32","description":"HTTP status code"},"scope":{"type":"string","description":"Scope of the rate limit: 'rest' for HTTP endpoints, 'ws' for WebSocket handshake","enum":["rest","ws"]},"bucket":{"type":"string","description":"Bucket that triggered the limit (e.g. 'rest_weight', 'orders', 'ws_handshake')"},"keyType":{"type":"string","description":"Key type that was rate limited: 'ip' or 'api'","enum":["ip","api"]},"retryAfterSec":{"type":"number","format":"double","description":"Seconds until enough tokens are available to retry this request"}},"required":["bucket","code","keyType","retryAfterSec","scope","status"]},"ProblemDetail":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer","format":"int32"},"detail":{"type":"string"},"instance":{"type":"string","format":"uri"},"properties":{"type":"object","additionalProperties":{}}}}},"responses":{"RateLimited":{"description":"Too Many Requests - Rate limit exceeded.","headers":{"X-PLEX-USED-WEIGHT-API":{"description":"Rounded burst capacity minus remaining verified API-key tokens (when authenticated accounting ran)","schema":{}},"Retry-After":{"description":"Whole seconds to wait before retrying (ceiling of the computed delay)","schema":{}},"X-PLEX-ORDER-COUNT":{"description":"Rounded order burst capacity minus remaining verified API-key order tokens (when order accounting ran)","schema":{}},"X-PLEX-USED-WEIGHT-IP":{"description":"Rounded burst capacity minus remaining IP tokens; on rejection, describes the rejecting bucket","schema":{}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}},"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}}}},"paths":{"/api/v1/vaults/{numericVaultId}/hedges":{"post":{"tags":["Vault hedging"],"summary":"Create a durable guarded hedge operation from one exact quote","description":"Consumes only the exact opaque quote identity. No approved amount, route, state, deadline, target,\nmanager, signer, or calldata may be replaced. A 202 response means durable intent admission, not\nconsensus or settlement; poll the returned operation link.\n\n\n**Weight:** 1","operationId":"createGuardedHedge","parameters":[{"name":"numericVaultId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuardedHedgeOperation"}}}},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"description":"Service Unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}}}}
```

## Create an immutable signer-free guarded hedge quote

> Requires an active V2-signed API key with immutable VAULT\_HEDGE\_ONLY authority for the exact\
> path vault. Lambdaplex derives vault and network identity, the active guard, state commitment, reviewed\
> Saucer V2 route, calldata, and simulation. The body cannot provide any execution target or signer.\
> All unsigned integer values are canonical decimal JSON strings.\
> \
> \
> \*\*Weight:\*\* 1

```json
{"openapi":"3.1.0","info":{"title":"Lambdaplex API","version":"1.0"},"tags":[{"name":"Vault hedging","description":"Typed guarded vault execution; V2 API signatures are mandatory"}],"servers":[{"url":"https://api.lambdaplex.io","description":"Generated server url"}],"security":[{"XApiKey":[],"Ed25519Sig":[]}],"components":{"securitySchemes":{"XApiKey":{"type":"apiKey","description":"API key identifier. For Ed25519 V2 operations, its exact header value is the second line of the canonical signing payload.","name":"X-API-KEY","in":"header"}},"schemas":{"GuardedHedgeQuote":{"type":"object","properties":{"quoteId":{"type":"string","format":"uuid"},"clientRequestId":{"type":"string","format":"uuid"},"status":{"type":"string"},"makerPolicy":{"type":"string"},"hedgeDirection":{"type":"string"},"amountMode":{"type":"string"},"chainId":{"type":"string"},"network":{"type":"string"},"vault":{"type":"string"},"guard":{"type":"string"},"operator":{"type":"string"},"riskEpochId":{"type":"string","format":"uuid"},"residualVersion":{"type":"string"},"economicObligationId":{"type":"string"},"guardBindingId":{"type":"string"},"guardedHedgeId":{"type":"string"},"marketHash":{"type":"string"},"configurationHash":{"type":"string"},"obligationKeyHash":{"type":"string"},"riskApprovalEvidenceHash":{"type":"string"},"expectedStateCommitment":{"type":"string"},"invocationHash":{"type":"string"},"routeHash":{"type":"string"},"inputToken":{"type":"string"},"outputToken":{"type":"string"},"amountIn":{"type":"string"},"quotedAmountOut":{"type":"string"},"amountOutMin":{"type":"string"},"observedAt":{"type":"string"},"expiresAt":{"type":"string"},"contractDeadline":{"type":"string"},"observationBlockNumber":{"type":"string"},"observationBlockHash":{"type":"string"},"observationEvidenceHash":{"type":"string"},"simulationEvidenceHash":{"type":"string"},"simulationOutcome":{"type":"string"},"_links":{"$ref":"#/components/schemas/Links"}}},"Links":{"type":"object","properties":{"self":{"type":"string"}}},"RateLimitError":{"type":"object","description":"Error response returned when a request is rate limited (HTTP 429)","properties":{"code":{"type":"string","description":"Error code indicating rate limiting"},"status":{"type":"integer","format":"int32","description":"HTTP status code"},"scope":{"type":"string","description":"Scope of the rate limit: 'rest' for HTTP endpoints, 'ws' for WebSocket handshake","enum":["rest","ws"]},"bucket":{"type":"string","description":"Bucket that triggered the limit (e.g. 'rest_weight', 'orders', 'ws_handshake')"},"keyType":{"type":"string","description":"Key type that was rate limited: 'ip' or 'api'","enum":["ip","api"]},"retryAfterSec":{"type":"number","format":"double","description":"Seconds until enough tokens are available to retry this request"}},"required":["bucket","code","keyType","retryAfterSec","scope","status"]},"ProblemDetail":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer","format":"int32"},"detail":{"type":"string"},"instance":{"type":"string","format":"uri"},"properties":{"type":"object","additionalProperties":{}}}}},"responses":{"RateLimited":{"description":"Too Many Requests - Rate limit exceeded.","headers":{"X-PLEX-USED-WEIGHT-API":{"description":"Rounded burst capacity minus remaining verified API-key tokens (when authenticated accounting ran)","schema":{}},"Retry-After":{"description":"Whole seconds to wait before retrying (ceiling of the computed delay)","schema":{}},"X-PLEX-ORDER-COUNT":{"description":"Rounded order burst capacity minus remaining verified API-key order tokens (when order accounting ran)","schema":{}},"X-PLEX-USED-WEIGHT-IP":{"description":"Rounded burst capacity minus remaining IP tokens; on rejection, describes the rejecting bucket","schema":{}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}},"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}}}},"paths":{"/api/v1/vaults/{numericVaultId}/hedge-quotes":{"post":{"tags":["Vault hedging"],"summary":"Create an immutable signer-free guarded hedge quote","description":"Requires an active V2-signed API key with immutable VAULT_HEDGE_ONLY authority for the exact\npath vault. Lambdaplex derives vault and network identity, the active guard, state commitment, reviewed\nSaucer V2 route, calldata, and simulation. The body cannot provide any execution target or signer.\nAll unsigned integer values are canonical decimal JSON strings.\n\n\n**Weight:** 1","operationId":"createGuardedHedgeQuote","parameters":[{"name":"numericVaultId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuardedHedgeQuote"}}}},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"description":"Service Unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}}}}
```

## Get one guarded hedge operation

> \*\*Weight:\*\* 1

```json
{"openapi":"3.1.0","info":{"title":"Lambdaplex API","version":"1.0"},"tags":[{"name":"Vault hedging","description":"Typed guarded vault execution; V2 API signatures are mandatory"}],"servers":[{"url":"https://api.lambdaplex.io","description":"Generated server url"}],"security":[{"XApiKey":[],"Ed25519Sig":[]}],"components":{"securitySchemes":{"XApiKey":{"type":"apiKey","description":"API key identifier. For Ed25519 V2 operations, its exact header value is the second line of the canonical signing payload.","name":"X-API-KEY","in":"header"}},"schemas":{"GuardedHedgeOperation":{"type":"object","properties":{"operationId":{"type":"string","format":"uuid"},"quoteId":{"type":"string","format":"uuid"},"operationVersion":{"type":"string"},"physicalAttempt":{"type":"integer","format":"int32"},"lifecycleState":{"type":"string"},"effectState":{"type":"string"},"settlementState":{"type":"string"},"consensusState":{"type":"string"},"chainId":{"type":"string"},"vault":{"type":"string"},"guard":{"type":"string"},"operator":{"type":"string"},"makerPolicy":{"type":"string"},"hedgeDirection":{"type":"string"},"amountMode":{"type":"string"},"amountIn":{"type":"string"},"amountOutMin":{"type":"string"},"economicObligationId":{"type":"string"},"guardBindingId":{"type":"string"},"guardedHedgeId":{"type":"string"},"stateCommitment":{"type":"string"},"invocationHash":{"type":"string"},"routeHash":{"type":"string"},"observationEvidenceHash":{"type":"string"},"simulationEvidenceHash":{"type":"string"},"transactionId":{"type":"string"},"expectedNativeTransactionHash":{"type":"string"},"expectedEvmTransactionHash":{"type":"string"},"finalStatus":{"type":"string"},"finalConsensusNs":{"type":"string"},"amountOutActual":{"type":"string"},"proof":{"$ref":"#/components/schemas/Proof"},"failure":{"$ref":"#/components/schemas/Failure"},"replacementEligible":{"type":"boolean"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"_links":{"$ref":"#/components/schemas/Links"}}},"Proof":{"type":"object","properties":{"transactionBodyHash":{"type":"string"},"signedTransactionHash":{"type":"string"},"validUntil":{"type":"string"},"submissionAttempts":{"type":"integer","format":"int32"},"precheckCode":{"type":"string"},"precheckAt":{"type":"string"},"finalityEvidenceHash":{"type":"string"},"settlementEvidenceSource":{"type":"string"},"settlementEvidenceVersion":{"type":"string"},"settlementEvidenceHash":{"type":"string"},"noEffectProofKind":{"type":"string"},"noEffectEvidenceHash":{"type":"string"},"accountingProof":{"$ref":"#/components/schemas/GuardedHedgeAccountingProof"},"absenceWatermarkBlock":{"type":"string"},"absenceWatermarkConsensus":{"type":"string"},"absencePagesScanned":{"type":"integer","format":"int32"},"absenceProvedAt":{"type":"string"},"readjudication":{"$ref":"#/components/schemas/Readjudication"}}},"GuardedHedgeAccountingProof":{"type":"object","properties":{"codec":{"type":"string"},"operationId":{"type":"string","format":"uuid"},"quoteId":{"type":"string","format":"uuid"},"chainId":{"type":"string"},"vaultAccountId":{"type":"string"},"baseTokenId":{"type":"string"},"quoteTokenId":{"type":"string"},"baseBalanceBefore":{"type":"string"},"baseBalanceAfter":{"type":"string"},"quoteBalanceBefore":{"type":"string"},"quoteBalanceAfter":{"type":"string"},"amountIn":{"type":"string"},"amountOutMin":{"type":"string"},"amountOutActual":{"type":"string"},"baseMutation":{"$ref":"#/components/schemas/Mutation"},"quoteMutation":{"$ref":"#/components/schemas/Mutation"},"finalConsensusNs":{"type":"string"},"accountingEvidenceSource":{"type":"string"},"accountingEvidenceVersion":{"type":"string"},"accountingAppliedAt":{"type":"string"},"feeAttribution":{"type":"string"},"ownerAttributedNetworkFee":{"type":"string"},"proofHash":{"type":"string"}}},"Mutation":{"type":"object","properties":{"consensusNs":{"type":"string"},"eventId":{"type":"string"},"aggregateId":{"type":"string","format":"uuid"},"eventType":{"type":"string"},"payloadSha256":{"type":"string"}}},"Readjudication":{"type":"object","properties":{"kind":{"type":"string"},"supersededFailureStage":{"type":"string"},"supersededFailureReason":{"type":"string"},"priorVersion":{"type":"string"},"readjudicatedAt":{"type":"string"},"operatorPrincipal":{"type":"string"}}},"Failure":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"Links":{"type":"object","properties":{"self":{"type":"string"}}},"RateLimitError":{"type":"object","description":"Error response returned when a request is rate limited (HTTP 429)","properties":{"code":{"type":"string","description":"Error code indicating rate limiting"},"status":{"type":"integer","format":"int32","description":"HTTP status code"},"scope":{"type":"string","description":"Scope of the rate limit: 'rest' for HTTP endpoints, 'ws' for WebSocket handshake","enum":["rest","ws"]},"bucket":{"type":"string","description":"Bucket that triggered the limit (e.g. 'rest_weight', 'orders', 'ws_handshake')"},"keyType":{"type":"string","description":"Key type that was rate limited: 'ip' or 'api'","enum":["ip","api"]},"retryAfterSec":{"type":"number","format":"double","description":"Seconds until enough tokens are available to retry this request"}},"required":["bucket","code","keyType","retryAfterSec","scope","status"]},"ProblemDetail":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer","format":"int32"},"detail":{"type":"string"},"instance":{"type":"string","format":"uri"},"properties":{"type":"object","additionalProperties":{}}}}},"responses":{"RateLimited":{"description":"Too Many Requests - Rate limit exceeded.","headers":{"X-PLEX-USED-WEIGHT-API":{"description":"Rounded burst capacity minus remaining verified API-key tokens (when authenticated accounting ran)","schema":{}},"Retry-After":{"description":"Whole seconds to wait before retrying (ceiling of the computed delay)","schema":{}},"X-PLEX-ORDER-COUNT":{"description":"Rounded order burst capacity minus remaining verified API-key order tokens (when order accounting ran)","schema":{}},"X-PLEX-USED-WEIGHT-IP":{"description":"Rounded burst capacity minus remaining IP tokens; on rejection, describes the rejecting bucket","schema":{}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}},"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}}}},"paths":{"/api/v1/vaults/{numericVaultId}/hedges/{operationId}":{"get":{"tags":["Vault hedging"],"summary":"Get one guarded hedge operation","description":"**Weight:** 1","operationId":"getGuardedHedge","parameters":[{"name":"numericVaultId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"operationId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuardedHedgeOperation"}}}},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"description":"Service Unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}}}}
```

## Inspect the exact guarded hedge credential and protocol capability

> \*\*Weight:\*\* 1

```json
{"openapi":"3.1.0","info":{"title":"Lambdaplex API","version":"1.0"},"tags":[{"name":"Vault hedging","description":"Typed guarded vault execution; V2 API signatures are mandatory"}],"servers":[{"url":"https://api.lambdaplex.io","description":"Generated server url"}],"security":[{"XApiKey":[],"Ed25519Sig":[]}],"components":{"securitySchemes":{"XApiKey":{"type":"apiKey","description":"API key identifier. For Ed25519 V2 operations, its exact header value is the second line of the canonical signing payload.","name":"X-API-KEY","in":"header"}},"schemas":{"GuardedHedgeCapability":{"type":"object","properties":{"permissionProfile":{"type":"string"},"vaultAccountId":{"type":"string"},"botWithdrawalsEnabled":{"type":"boolean"},"publicKeyFingerprintAlgorithm":{"type":"string"},"publicKeyFingerprint":{"type":"string"},"guardedHedgeApiContractVersion":{"type":"string"},"fixtureManifestSha256":{"type":"string"}}},"RateLimitError":{"type":"object","description":"Error response returned when a request is rate limited (HTTP 429)","properties":{"code":{"type":"string","description":"Error code indicating rate limiting"},"status":{"type":"integer","format":"int32","description":"HTTP status code"},"scope":{"type":"string","description":"Scope of the rate limit: 'rest' for HTTP endpoints, 'ws' for WebSocket handshake","enum":["rest","ws"]},"bucket":{"type":"string","description":"Bucket that triggered the limit (e.g. 'rest_weight', 'orders', 'ws_handshake')"},"keyType":{"type":"string","description":"Key type that was rate limited: 'ip' or 'api'","enum":["ip","api"]},"retryAfterSec":{"type":"number","format":"double","description":"Seconds until enough tokens are available to retry this request"}},"required":["bucket","code","keyType","retryAfterSec","scope","status"]},"ProblemDetail":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer","format":"int32"},"detail":{"type":"string"},"instance":{"type":"string","format":"uri"},"properties":{"type":"object","additionalProperties":{}}}}},"responses":{"RateLimited":{"description":"Too Many Requests - Rate limit exceeded.","headers":{"X-PLEX-USED-WEIGHT-API":{"description":"Rounded burst capacity minus remaining verified API-key tokens (when authenticated accounting ran)","schema":{}},"Retry-After":{"description":"Whole seconds to wait before retrying (ceiling of the computed delay)","schema":{}},"X-PLEX-ORDER-COUNT":{"description":"Rounded order burst capacity minus remaining verified API-key order tokens (when order accounting ran)","schema":{}},"X-PLEX-USED-WEIGHT-IP":{"description":"Rounded burst capacity minus remaining IP tokens; on rejection, describes the rejecting bucket","schema":{}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}},"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}}}},"paths":{"/api/v1/vaults/{numericVaultId}/hedge-capability":{"get":{"tags":["Vault hedging"],"summary":"Inspect the exact guarded hedge credential and protocol capability","description":"**Weight:** 1","operationId":"getGuardedHedgeCapability","parameters":[{"name":"numericVaultId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuardedHedgeCapability"}}}},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"description":"Service Unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}}}}
```