# Generated by pnpm api:openapi:generate. Do not edit by hand. components: parameters: {} schemas: ApiIdentity: properties: apiKeyId: example: 5e1d3c8a-c866-4f5f-974d-36ca7f6f6918 format: uuid type: string environment: $ref: "#/components/schemas/ApiKeyEnvironment" expiresAt: format: date-time type: string name: maxLength: 80 minLength: 1 type: string scopes: items: $ref: "#/components/schemas/ApiScope" type: array userId: format: uuid type: string walletAddress: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string required: - apiKeyId - userId - walletAddress - name - environment - scopes - expiresAt type: object ApiKeyEnvironment: enum: - development - staging - production type: string ApiScope: enum: - tokens:read - market-data:read - launches:read - launches:write - trading:write - staking:read - staking:write - fees:read - fees:write - predictions:read - predictions:write - predictions:delegate - presales:read - presales:write - token-management:write - audience:read - webhooks:read - webhooks:write - operations:read - transactions:write type: string Candle: properties: close: example: "0.00001234" pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]*[1-9])?$ type: string high: example: "0.00001234" pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]*[1-9])?$ type: string low: example: "0.00001234" pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]*[1-9])?$ type: string open: example: "0.00001234" pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]*[1-9])?$ type: string time: format: date-time type: string trades: minimum: 0 type: integer volumeInSol: example: "0.00001234" pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]*[1-9])?$ type: string required: - time - open - high - low - close - volumeInSol - trades type: object CandleSeries: properties: data: items: $ref: "#/components/schemas/Candle" maxItems: 1000 type: array from: format: date-time type: string interval: enum: - 1m - 5m - 15m - 1h - 4h - 1d type: string provenance: enum: - blank-indexer type: string to: format: date-time type: string required: - data - interval - from - to - provenance type: object CursorPage: properties: hasMore: type: boolean nextCursor: example: eyJ2IjoxLCJzb3J0IjpbIjIwMjYtMDgtMDlUMDA6MDA6MDBaIl19 maxLength: 2048 minLength: 16 pattern: ^[A-Za-z0-9_-]+$ type: - string - "null" required: - nextCursor - hasMore type: object DelegatedPredictionIntent: properties: action: enum: - prediction.submit type: string expiresAt: format: date-time type: string id: format: uuid type: string message: maxLength: 1024 minLength: 1 type: string mintAddress: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string network: enum: - devnet - mainnet type: string predictedPriceInSol: example: "0.00001234" pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]*[1-9])?$ type: string roundId: format: uuid type: string version: enum: - 1 type: number walletAddress: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string required: - id - version - action - roundId - mintAddress - network - walletAddress - predictedPriceInSol - message - expiresAt type: object DelegatedPredictionSubmission: additionalProperties: false properties: intentId: format: uuid type: string signature: pattern: ^[1-9A-HJ-NP-Za-km-z]{87,88}$ type: string required: - intentId - signature type: object FeeDistribution: properties: amountInSol: example: "0.00001234" pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]*[1-9])?$ type: string collectedAt: format: date-time type: string feeType: enum: - creation - trade - graduation type: string id: format: uuid type: string recipient: enum: - platform - creator - staking type: string slot: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: - string - "null" transactionSignature: maxLength: 128 minLength: 32 type: - string - "null" required: - id - feeType - recipient - amountInSol - transactionSignature - slot - collectedAt type: object FeeDistributionCollection: properties: data: items: $ref: "#/components/schemas/FeeDistribution" type: array page: $ref: "#/components/schemas/CursorPage" required: - data - page type: object FeeState: properties: controllerWallet: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string lastDistributionAt: format: date-time type: - string - "null" mintAddress: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string sharesBps: properties: buybackBurn: maximum: 10000 minimum: 0 type: integer creator: maximum: 10000 minimum: 0 type: integer forecast: maximum: 10000 minimum: 0 type: integer liquidityCompounding: maximum: 10000 minimum: 0 type: integer staking: maximum: 10000 minimum: 0 type: integer required: - creator - staking - buybackBurn - liquidityCompounding - forecast type: object totalDistributedInSol: example: "0.00001234" pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]*[1-9])?$ type: string required: - mintAddress - controllerWallet - sharesBps - totalDistributedInSol - lastDistributionAt type: object HolderStats: properties: asOf: format: date-time type: string holderCount: minimum: 0 type: integer mintAddress: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string provenance: enum: - live_trade_index - trade_replay - onchain_snapshot type: string slot: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: - string - "null" required: - mintAddress - holderCount - slot - asOf - provenance type: object MarketSnapshot: properties: asOf: format: date-time type: string holderCount: minimum: 0 type: - integer - "null" liquidityInSol: example: "0.00001234" pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]*[1-9])?$ type: string marketCapInSol: example: "0.00001234" pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]*[1-9])?$ type: string mintAddress: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string priceInSol: example: "0.00001234" pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]*[1-9])?$ type: string provenance: enum: - blank-indexer type: string totalSupply: example: "0.00001234" pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]*[1-9])?$ type: string required: - mintAddress - priceInSol - marketCapInSol - liquidityInSol - totalSupply - holderCount - asOf - provenance type: object Operation: properties: completedAt: format: date-time type: - string - "null" createdAt: format: date-time type: string error: $ref: "#/components/schemas/ProblemDetails" id: example: 24c85940-7968-4b71-92dd-0d8f017cea5a format: uuid type: string kind: pattern: ^[a-z][a-z0-9_]*$ type: string progress: $ref: "#/components/schemas/OperationProgress" resultUrl: format: uri type: - string - "null" startedAt: format: date-time type: - string - "null" status: $ref: "#/components/schemas/OperationStatus" required: - id - kind - status - createdAt - startedAt - completedAt - resultUrl - error type: object OperationProgress: properties: completed: minimum: 0 type: integer total: exclusiveMinimum: 0 type: integer unit: maxLength: 64 minLength: 1 type: string required: - completed - total type: object OperationStatus: enum: - queued - running - succeeded - failed - cancelled type: string Prediction: properties: baselineBalanceRaw: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: string baselineBalanceSlot: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: - string - "null" baselineEligible: type: boolean distancePpm: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: - string - "null" id: format: uuid type: string mintAddress: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string predictedPriceInSol: example: "0.00001234" pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]*[1-9])?$ type: string rank: exclusiveMinimum: 0 type: - integer - "null" roundId: format: uuid type: string settlementEligible: type: - boolean - "null" status: enum: - active - ineligible - voided type: string submissionSource: enum: - web - api_v2 type: string submittedAt: format: date-time type: string username: maxLength: 64 minLength: 1 type: string walletAddress: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string required: - id - roundId - mintAddress - walletAddress - username - predictedPriceInSol - status - baselineEligible - baselineBalanceRaw - baselineBalanceSlot - settlementEligible - distancePpm - rank - submissionSource - submittedAt type: object PredictionEligibility: properties: balanceRaw: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: - string - "null" eligible: type: boolean evaluatedAt: format: date-time type: string evaluationSlot: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: - string - "null" locksAt: format: date-time type: string minimumBalanceRaw: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: string reasons: items: enum: - username_required - wallet_not_verified - insufficient_balance - round_not_open - token_not_enabled type: string type: array roundId: format: uuid type: string roundStatus: enum: - scheduled - open - locked - settling - settled - voided type: string walletAddress: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string required: - roundId - walletAddress - eligible - roundStatus - locksAt - reasons - balanceRaw - minimumBalanceRaw - evaluationSlot - evaluatedAt type: object PredictionList: oneOf: - properties: participantCount: minimum: 0 type: integer visibility: enum: - aggregate type: string required: - visibility - participantCount type: object - properties: data: items: $ref: "#/components/schemas/PublicPredictionEntry" maxItems: 100 type: array participantCount: minimum: 0 type: integer visibility: enum: - exact type: string required: - visibility - participantCount - data type: object PredictionRound: properties: baselinePriceInSol: example: "0.00001234" pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]*[1-9])?$ type: - string - "null" id: format: uuid type: string locksAt: format: date-time type: string mintAddress: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string opensAt: format: date-time type: string predictionCount: minimum: 0 type: integer prizePoolLamports: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: string roundNumber: exclusiveMinimum: 0 type: integer settledAt: format: date-time type: - string - "null" settlementPriceInSol: example: "0.00001234" pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]*[1-9])?$ type: - string - "null" settlementWindowEnd: format: date-time type: string settlementWindowStart: format: date-time type: string status: enum: - scheduled - open - locked - settling - settled - voided type: string required: - id - mintAddress - roundNumber - status - opensAt - locksAt - settlementWindowStart - settlementWindowEnd - baselinePriceInSol - settlementPriceInSol - prizePoolLamports - predictionCount - settledAt type: object PredictionRoundCollection: properties: data: items: $ref: "#/components/schemas/PredictionRound" type: array page: $ref: "#/components/schemas/CursorPage" required: - data - page type: object PredictionStanding: allOf: - $ref: "#/components/schemas/PublicPredictionEntry" - properties: payoutLamports: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: - string - "null" rank: exclusiveMinimum: 0 type: integer required: - payoutLamports type: object PredictionStandings: properties: data: items: $ref: "#/components/schemas/PredictionStanding" maxItems: 100 type: array required: - data type: object PredictionSubmission: additionalProperties: false properties: predictedPriceInSol: example: "0.00001234" pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]*[1-9])?$ type: string roundId: format: uuid type: string walletAddress: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string required: - roundId - walletAddress - predictedPriceInSol type: object Presale: properties: allocationsBps: properties: burn: maximum: 10000 minimum: 0 type: integer pool: maximum: 10000 minimum: 0 type: integer sale: maximum: 10000 minimum: 0 type: integer required: - sale - pool - burn type: object createdAt: format: date-time type: string creatorCommitmentLamports: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: string deadline: format: date-time type: string id: format: uuid type: string maxCapLamports: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: string minCapLamports: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: string mintAddress: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string participantCount: minimum: 0 type: integer perWalletCapLamports: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: string publicStartAt: format: date-time type: string status: enum: - draft - initializing - active - settling - settled - refunding - failed type: string totalDepositedLamports: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: string updatedAt: format: date-time type: string required: - id - mintAddress - status - minCapLamports - maxCapLamports - perWalletCapLamports - creatorCommitmentLamports - totalDepositedLamports - participantCount - publicStartAt - deadline - allocationsBps - createdAt - updatedAt type: object PresaleCollection: properties: data: items: $ref: "#/components/schemas/Presale" type: array page: $ref: "#/components/schemas/CursorPage" required: - data - page type: object PresaleParticipant: properties: claimTransactionSignature: maxLength: 128 minLength: 32 type: - string - "null" depositedLamports: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: string presaleId: format: uuid type: string refundTransactionSignature: maxLength: 128 minLength: 32 type: - string - "null" status: enum: - active - claimable - claimed - refundable - refunded type: string tokenAllocationRaw: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: - string - "null" updatedAt: format: date-time type: string walletAddress: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string required: - presaleId - walletAddress - depositedLamports - tokenAllocationRaw - status - claimTransactionSignature - refundTransactionSignature - updatedAt type: object ProblemCause: properties: code: enum: - invalid_api_key - insufficient_scope - not_found - method_not_allowed - precondition_required - precondition_invalid - validation_failed - malformed_json - unsupported_content_type - request_body_too_large - idempotency_key_invalid - idempotency_key_reused - idempotency_request_in_progress - precondition_failed - cursor_invalid - rate_limit_exceeded - rate_limit_unavailable - api_dependency_unavailable - internal_error - invalid_error_response - token_not_found - holder_stats_not_found - market_time_range_invalid - token_index_unavailable - market_data_unavailable - identity_unavailable - staking_pool_not_found - presale_not_found - presale_participation_not_found - manifest_unavailable - prediction_wallet_mismatch - prediction_authorization_invalid - prediction_intent_not_found - prediction_round_not_found - prediction_not_found - prediction_token_not_enabled - prediction_round_not_open - prediction_wallet_not_verified - prediction_username_required - prediction_insufficient_balance - prediction_already_submitted - prediction_intent_expired - prediction_intent_consumed - prediction_exact_values_locked - prediction_price_out_of_range - prediction_balance_unavailable - operation_not_found - transaction_intent_not_found - transaction_intent_not_prepared - transaction_intent_expired - transaction_intent_version_conflict - transaction_intent_tampered - transaction_intent_wrong_signer - transaction_intent_invalid_signature - webhook_endpoint_not_found - webhook_delivery_not_found - webhook_delivery_not_replayable - webhook_endpoint_limit_reached - webhook_delivery_replay_limit_reached - webhook_url_disallowed type: string context: additionalProperties: oneOf: - maxLength: 1024 type: string - type: number - type: boolean - type: "null" type: object detail: maxLength: 2000 minLength: 1 type: string title: maxLength: 200 minLength: 1 type: string required: - code - title - detail type: object ProblemDetails: properties: causes: items: $ref: "#/components/schemas/ProblemCause" maxItems: 20 type: array code: enum: - invalid_api_key - insufficient_scope - not_found - method_not_allowed - precondition_required - precondition_invalid - validation_failed - malformed_json - unsupported_content_type - request_body_too_large - idempotency_key_invalid - idempotency_key_reused - idempotency_request_in_progress - precondition_failed - cursor_invalid - rate_limit_exceeded - rate_limit_unavailable - api_dependency_unavailable - internal_error - invalid_error_response - token_not_found - holder_stats_not_found - market_time_range_invalid - token_index_unavailable - market_data_unavailable - identity_unavailable - staking_pool_not_found - presale_not_found - presale_participation_not_found - manifest_unavailable - prediction_wallet_mismatch - prediction_authorization_invalid - prediction_intent_not_found - prediction_round_not_found - prediction_not_found - prediction_token_not_enabled - prediction_round_not_open - prediction_wallet_not_verified - prediction_username_required - prediction_insufficient_balance - prediction_already_submitted - prediction_intent_expired - prediction_intent_consumed - prediction_exact_values_locked - prediction_price_out_of_range - prediction_balance_unavailable - operation_not_found - transaction_intent_not_found - transaction_intent_not_prepared - transaction_intent_expired - transaction_intent_version_conflict - transaction_intent_tampered - transaction_intent_wrong_signer - transaction_intent_invalid_signature - webhook_endpoint_not_found - webhook_delivery_not_found - webhook_delivery_not_replayable - webhook_endpoint_limit_reached - webhook_delivery_replay_limit_reached - webhook_url_disallowed type: string context: additionalProperties: oneOf: - maxLength: 1024 type: string - type: number - type: boolean - type: "null" type: object detail: maxLength: 2000 minLength: 1 type: string errors: items: $ref: "#/components/schemas/ProblemFieldError" maxItems: 100 type: array instance: maxLength: 2048 minLength: 1 type: string requestId: example: req_0123456789abcdef0123456789abcdef pattern: ^req_[0-9a-f]{32}$ type: string status: maximum: 599 minimum: 400 type: integer title: maxLength: 200 minLength: 1 type: string type: minLength: 1 type: string required: - type - title - status - detail - instance - code - requestId type: - object - "null" ProblemFieldError: properties: code: pattern: ^[a-z][a-z0-9_]*$ type: string message: maxLength: 1024 minLength: 1 type: string path: maxLength: 512 minLength: 1 type: string required: - path - code - message type: object PublicPredictionEntry: properties: distancePpm: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: - string - "null" id: format: uuid type: string predictedPriceInSol: example: "0.00001234" pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]*[1-9])?$ type: string rank: exclusiveMinimum: 0 type: - integer - "null" submittedAt: format: date-time type: string username: maxLength: 64 minLength: 1 type: string walletAddress: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string required: - id - walletAddress - username - predictedPriceInSol - rank - distancePpm - submittedAt type: object SolanaManifest: properties: apiVersion: enum: - "2" type: string environment: $ref: "#/components/schemas/ApiKeyEnvironment" idl: properties: feeSplitter: format: uri type: string staking: format: uri type: string tokenomics: format: uri type: string required: - feeSplitter - staking - tokenomics type: object launchSigner: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string limits: properties: activeApiKeysPerEnvironment: exclusiveMinimum: 0 type: integer metadataUriBytes: exclusiveMinimum: 0 type: integer transactionSafeBytes: exclusiveMinimum: 0 type: integer transactionSolanaBytes: exclusiveMinimum: 0 type: integer required: - activeApiKeysPerEnvironment - metadataUriBytes - transactionSafeBytes - transactionSolanaBytes type: object lookupTable: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: - string - "null" manifestVersion: minLength: 1 type: string programIds: properties: dbc: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string feeSplitter: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string staking: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string tokenomics: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string required: - dbc - feeSplitter - staking - tokenomics type: object sdkVersion: example: 4.0.0 minLength: 1 type: string required: - apiVersion - sdkVersion - manifestVersion - environment - programIds - idl - lookupTable - launchSigner - limits type: object StakingLeaderboard: properties: data: items: $ref: "#/components/schemas/StakingLeaderboardEntry" maxItems: 100 type: array required: - data type: object StakingLeaderboardEntry: properties: amountRaw: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: string positionCount: exclusiveMinimum: 0 type: integer rank: exclusiveMinimum: 0 type: integer walletAddress: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string weightedAmountRaw: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: string required: - rank - walletAddress - amountRaw - weightedAmountRaw - positionCount type: object StakingPool: properties: accumulatedRewardsLamports: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: string activeStakers: minimum: 0 type: integer allocationBps: maximum: 10000 minimum: 0 type: integer aprPercent: example: "0.00001234" pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]*[1-9])?$ type: - string - "null" asOf: format: date-time type: string enabled: type: boolean lastSyncedSlot: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: - string - "null" mintAddress: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string poolAddress: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string totalStakedRaw: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: string totalWeightedStakeRaw: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: string required: - mintAddress - poolAddress - enabled - allocationBps - totalStakedRaw - totalWeightedStakeRaw - accumulatedRewardsLamports - activeStakers - aprPercent - asOf - lastSyncedSlot type: object StakingPosition: properties: amountRaw: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: string funderWallet: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string id: format: uuid type: string lockEnd: format: date-time type: string lockPeriod: enum: - week - month - quarter - half_year type: string lockStart: format: date-time type: string mintAddress: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string ownerWallet: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string positionIndex: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: string transactionSignature: maxLength: 128 minLength: 32 type: - string - "null" updatedAt: format: date-time type: string weightedAmountRaw: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: string required: - id - mintAddress - ownerWallet - funderWallet - positionIndex - amountRaw - weightedAmountRaw - lockPeriod - lockStart - lockEnd - transactionSignature - updatedAt type: object StakingPositionCollection: properties: data: items: $ref: "#/components/schemas/StakingPosition" type: array page: $ref: "#/components/schemas/CursorPage" required: - data - page type: object Token: properties: creatorWallet: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string currentPriceInSol: example: "0.00001234" pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]*[1-9])?$ type: string description: type: - string - "null" graduatedAt: format: date-time type: - string - "null" imageUrl: format: uri type: - string - "null" launchType: enum: - dbc - pre_raise type: string launchedAt: format: date-time type: string mintAddress: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string name: maxLength: 128 minLength: 1 type: string solCollectedInSol: example: "0.00001234" pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]*[1-9])?$ type: string status: enum: - pending - pending_launch_init - pending_escrows - pending_finalization - bonding - pre_raise_pending - pre_raising - pre_raise_settling - pre_raise_refunding - pre_raise_failed - graduating_migration_pending - graduated - graduation_failed - expired - cancelled - failed type: string symbol: maxLength: 32 minLength: 1 type: string totalSupply: example: "0.00001234" pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]*[1-9])?$ type: string required: - mintAddress - name - symbol - description - imageUrl - status - launchType - creatorWallet - currentPriceInSol - solCollectedInSol - totalSupply - launchedAt - graduatedAt type: object TokenCollection: properties: data: items: $ref: "#/components/schemas/Token" type: array page: $ref: "#/components/schemas/CursorPage" required: - data - page type: object Trade: properties: blockTime: format: date-time type: string id: format: uuid type: string pricePerTokenInSol: example: "0.00001234" pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]*[1-9])?$ type: string slot: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: - string - "null" solAmount: example: "0.00001234" pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]*[1-9])?$ type: string tokenAmount: example: "0.00001234" pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]*[1-9])?$ type: string traderWallet: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string transactionSignature: maxLength: 128 minLength: 32 type: string type: enum: - buy - sell type: string required: - id - type - traderWallet - tokenAmount - solAmount - pricePerTokenInSol - transactionSignature - slot - blockTime type: object TradeCollection: properties: data: items: $ref: "#/components/schemas/Trade" type: array page: $ref: "#/components/schemas/CursorPage" required: - data - page type: object TransactionIntent: properties: completedAt: format: date-time type: - string - "null" createdAt: format: date-time type: string error: $ref: "#/components/schemas/TransactionIntentSafeError" expectedSigner: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string expiresAt: format: date-time type: string id: format: uuid type: string kind: pattern: ^[a-z][a-z0-9_]*$ type: string lastValidBlockHeight: example: "1000000000" pattern: ^(?:0|[1-9][0-9]*)$ type: - string - "null" policy: additionalProperties: {} type: object recentBlockhash: maxLength: 64 minLength: 32 type: - string - "null" serializedTransaction: maxLength: 2500 minLength: 1 type: string status: enum: - prepared - submitted - confirmed - expired - failed type: string submittedAt: format: date-time type: - string - "null" transactionSignature: maxLength: 128 minLength: 32 type: - string - "null" version: exclusiveMinimum: 0 type: integer required: - id - kind - status - expectedSigner - serializedTransaction - recentBlockhash - lastValidBlockHeight - policy - transactionSignature - error - version - expiresAt - createdAt - submittedAt - completedAt type: object TransactionIntentSafeError: properties: code: enum: - solana_transaction_failed - transaction_intent_invalid_state - transaction_intent_expired - transaction_intent_broadcast_exhausted - solana_blockhash_expired - solana_signature_mismatch type: string detail: maxLength: 512 minLength: 1 type: string required: - code - detail type: - object - "null" TransactionIntentSubmission: additionalProperties: false properties: signedTransaction: maxLength: 2500 minLength: 1 type: string required: - signedTransaction type: object WebhookCloudEvent: properties: data: additionalProperties: {} type: object datacontenttype: enum: - application/json type: string id: format: uuid type: string source: enum: - https://api.blank.build type: string specversion: enum: - "1.0" type: string subject: maxLength: 256 minLength: 1 type: string time: format: date-time type: string type: enum: - build.blank.launch.created.v1 - build.blank.launch.confirmed.v1 - build.blank.trade.confirmed.v1 - build.blank.staking.position.updated.v1 - build.blank.fee.distribution.created.v1 - build.blank.prediction.submitted.v1 - build.blank.prediction.round.locked.v1 - build.blank.prediction.round.settled.v1 - build.blank.presale.updated.v1 - build.blank.audience-export.completed.v1 - build.blank.operation.failed.v1 type: string required: - specversion - id - source - type - subject - time - datacontenttype - data type: object WebhookDeletion: properties: deletedAt: format: date-time type: string id: format: uuid type: string required: - id - deletedAt type: object WebhookDelivery: properties: attemptCount: minimum: 0 type: integer createdAt: format: date-time type: string deliveredAt: format: date-time type: - string - "null" endpointId: format: uuid type: string eventId: format: uuid type: string eventType: enum: - build.blank.launch.created.v1 - build.blank.launch.confirmed.v1 - build.blank.trade.confirmed.v1 - build.blank.staking.position.updated.v1 - build.blank.fee.distribution.created.v1 - build.blank.prediction.submitted.v1 - build.blank.prediction.round.locked.v1 - build.blank.prediction.round.settled.v1 - build.blank.presale.updated.v1 - build.blank.audience-export.completed.v1 - build.blank.operation.failed.v1 type: string id: format: uuid type: string lastErrorCode: oneOf: - enum: - request_timeout - network_error - url_disallowed - redirect_limit_exceeded - redirect_location_missing type: string - pattern: ^http_[1-5][0-9]{2}$ type: string - type: "null" nextAttemptAt: format: date-time type: - string - "null" responseStatus: maximum: 599 minimum: 100 type: - integer - "null" status: enum: - pending - processing - succeeded - retrying - dead_letter type: string updatedAt: format: date-time type: string required: - id - endpointId - eventId - eventType - status - attemptCount - nextAttemptAt - responseStatus - lastErrorCode - deliveredAt - createdAt - updatedAt type: object WebhookDeliveryCollection: properties: data: items: $ref: "#/components/schemas/WebhookDelivery" type: array page: $ref: "#/components/schemas/CursorPage" required: - data - page type: object WebhookEndpoint: properties: createdAt: format: date-time type: string eventTypes: items: enum: - build.blank.launch.created.v1 - build.blank.launch.confirmed.v1 - build.blank.trade.confirmed.v1 - build.blank.staking.position.updated.v1 - build.blank.fee.distribution.created.v1 - build.blank.prediction.submitted.v1 - build.blank.prediction.round.locked.v1 - build.blank.prediction.round.settled.v1 - build.blank.presale.updated.v1 - build.blank.audience-export.completed.v1 - build.blank.operation.failed.v1 type: string maxItems: 11 minItems: 1 type: array id: format: uuid type: string name: maxLength: 80 minLength: 1 type: string status: enum: - active - disabled type: string updatedAt: format: date-time type: string url: format: uri type: string version: exclusiveMinimum: 0 type: integer required: - id - name - url - eventTypes - status - version - createdAt - updatedAt type: object WebhookEndpointCollection: properties: data: items: $ref: "#/components/schemas/WebhookEndpoint" type: array page: $ref: "#/components/schemas/CursorPage" required: - data - page type: object WebhookEndpointCreate: additionalProperties: false properties: eventTypes: items: enum: - build.blank.launch.created.v1 - build.blank.launch.confirmed.v1 - build.blank.trade.confirmed.v1 - build.blank.staking.position.updated.v1 - build.blank.fee.distribution.created.v1 - build.blank.prediction.submitted.v1 - build.blank.prediction.round.locked.v1 - build.blank.prediction.round.settled.v1 - build.blank.presale.updated.v1 - build.blank.audience-export.completed.v1 - build.blank.operation.failed.v1 type: string maxItems: 11 minItems: 1 type: array name: maxLength: 80 minLength: 1 type: string url: format: uri type: string required: - name - url - eventTypes type: object WebhookEndpointUpdate: additionalProperties: false properties: eventTypes: items: enum: - build.blank.launch.created.v1 - build.blank.launch.confirmed.v1 - build.blank.trade.confirmed.v1 - build.blank.staking.position.updated.v1 - build.blank.fee.distribution.created.v1 - build.blank.prediction.submitted.v1 - build.blank.prediction.round.locked.v1 - build.blank.prediction.round.settled.v1 - build.blank.presale.updated.v1 - build.blank.audience-export.completed.v1 - build.blank.operation.failed.v1 type: string maxItems: 11 minItems: 1 type: array name: maxLength: 80 minLength: 1 type: string status: enum: - active - disabled type: string url: format: uri type: string type: object WebhookEndpointWithSecret: properties: endpoint: $ref: "#/components/schemas/WebhookEndpoint" secret: pattern: ^whsec_[A-Za-z0-9_-]{43}$ type: string required: - endpoint - secret type: object WebhookSecretRotation: additionalProperties: false properties: overlapHours: default: 24 maximum: 24 minimum: 1 type: integer type: object securitySchemes: BlankApiKey: bearerFormat: blank_live_… or blank_test_… description: Server-side scoped Blank API key. Never embed it in browser or mobile code. scheme: bearer type: http info: description: Production developer API for Blank automation-grade product capabilities. title: Blank API version: 2.0.0 openapi: 3.1.1 paths: /delegated-predictions: post: description: Consumes a prediction intent after verifying the end user's Ed25519 wallet signature and current eligibility. operationId: createDelegatedPrediction parameters: - in: header name: idempotency-key required: true schema: example: launch-20260809-01 maxLength: 128 minLength: 8 pattern: ^[\x21-\x7E]+$ type: string requestBody: content: application/json: schema: $ref: "#/components/schemas/DelegatedPredictionSubmission" required: true responses: "201": content: application/json: schema: $ref: "#/components/schemas/Prediction" description: The immutable prediction owned by the signing user. "400": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - malformed_json type: string status: enum: - 400 type: number title: enum: - Malformed JSON type: string type: enum: - https://blank.build/docs/reference/errors#malformed_json type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - idempotency_key_invalid type: string status: enum: - 400 type: number title: enum: - Invalid idempotency key type: string type: enum: - https://blank.build/docs/reference/errors#idempotency_key_invalid type: string type: object description: "Problem response. Possible codes: idempotency_key_invalid, malformed_json." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "401": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - invalid_api_key type: string status: enum: - 401 type: number title: enum: - Invalid API key type: string type: enum: - https://blank.build/docs/reference/errors#invalid_api_key type: string type: object description: "Problem response. Possible codes: invalid_api_key." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "403": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_authorization_invalid type: string status: enum: - 403 type: number title: enum: - Prediction authorization invalid type: string type: enum: - https://blank.build/docs/reference/errors#prediction_authorization_invalid type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - insufficient_scope type: string status: enum: - 403 type: number title: enum: - Insufficient scope type: string type: enum: - https://blank.build/docs/reference/errors#insufficient_scope type: string type: object description: "Problem response. Possible codes: insufficient_scope, prediction_authorization_invalid." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "404": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_intent_not_found type: string status: enum: - 404 type: number title: enum: - Prediction intent not found type: string type: enum: - https://blank.build/docs/reference/errors#prediction_intent_not_found type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_round_not_found type: string status: enum: - 404 type: number title: enum: - Prediction round not found type: string type: enum: - https://blank.build/docs/reference/errors#prediction_round_not_found type: string type: object description: "Problem response. Possible codes: prediction_intent_not_found, prediction_round_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "409": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_intent_expired type: string status: enum: - 409 type: number title: enum: - Prediction intent expired type: string type: enum: - https://blank.build/docs/reference/errors#prediction_intent_expired type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_intent_consumed type: string status: enum: - 409 type: number title: enum: - Prediction intent consumed type: string type: enum: - https://blank.build/docs/reference/errors#prediction_intent_consumed type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_round_not_open type: string status: enum: - 409 type: number title: enum: - Prediction round not open type: string type: enum: - https://blank.build/docs/reference/errors#prediction_round_not_open type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_token_not_enabled type: string status: enum: - 409 type: number title: enum: - Predictions not enabled type: string type: enum: - https://blank.build/docs/reference/errors#prediction_token_not_enabled type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_wallet_not_verified type: string status: enum: - 409 type: number title: enum: - Wallet not verified type: string type: enum: - https://blank.build/docs/reference/errors#prediction_wallet_not_verified type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_username_required type: string status: enum: - 409 type: number title: enum: - Username required type: string type: enum: - https://blank.build/docs/reference/errors#prediction_username_required type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_insufficient_balance type: string status: enum: - 409 type: number title: enum: - Insufficient balance type: string type: enum: - https://blank.build/docs/reference/errors#prediction_insufficient_balance type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_already_submitted type: string status: enum: - 409 type: number title: enum: - Prediction already submitted type: string type: enum: - https://blank.build/docs/reference/errors#prediction_already_submitted type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - idempotency_key_reused type: string status: enum: - 409 type: number title: enum: - Idempotency key reused type: string type: enum: - https://blank.build/docs/reference/errors#idempotency_key_reused type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - idempotency_request_in_progress type: string status: enum: - 409 type: number title: enum: - Idempotency request in progress type: string type: enum: - https://blank.build/docs/reference/errors#idempotency_request_in_progress type: string type: object description: "Problem response. Possible codes: idempotency_key_reused, idempotency_request_in_progress, prediction_already_submitted, prediction_insufficient_balance, prediction_intent_consumed, prediction_intent_expired, prediction_round_not_open, prediction_token_not_enabled, prediction_username_required, prediction_wallet_not_verified." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "413": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - request_body_too_large type: string status: enum: - 413 type: number title: enum: - Request body too large type: string type: enum: - https://blank.build/docs/reference/errors#request_body_too_large type: string type: object description: "Problem response. Possible codes: request_body_too_large." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "415": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - unsupported_content_type type: string status: enum: - 415 type: number title: enum: - Unsupported content type type: string type: enum: - https://blank.build/docs/reference/errors#unsupported_content_type type: string type: object description: "Problem response. Possible codes: unsupported_content_type." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_balance_unavailable type: string status: enum: - 503 type: number title: enum: - Balance unavailable type: string type: enum: - https://blank.build/docs/reference/errors#prediction_balance_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, prediction_balance_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string security: - BlankApiKey: [] summary: Submit a delegated prediction tags: - Predictions /me: get: description: Returns only the API key identity, pinned wallet, environment, scopes, and expiry. operationId: getApiIdentity responses: "200": content: application/json: schema: $ref: "#/components/schemas/ApiIdentity" description: The authenticated API identity. "401": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - invalid_api_key type: string status: enum: - 401 type: number title: enum: - Invalid API key type: string type: enum: - https://blank.build/docs/reference/errors#invalid_api_key type: string type: object description: "Problem response. Possible codes: invalid_api_key." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - identity_unavailable type: string status: enum: - 503 type: number title: enum: - Identity unavailable type: string type: enum: - https://blank.build/docs/reference/errors#identity_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, identity_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string security: - BlankApiKey: [] summary: Inspect the current API identity tags: - Identity /operations/{operationId}: get: description: Returns an operation owned by the authenticated account. operationId: getOperation parameters: - in: path name: operationId required: true schema: format: uuid type: string responses: "200": content: application/json: schema: $ref: "#/components/schemas/Operation" description: Owned operation. "304": description: Not modified. The current ETag matched If-None-Match. "401": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - invalid_api_key type: string status: enum: - 401 type: number title: enum: - Invalid API key type: string type: enum: - https://blank.build/docs/reference/errors#invalid_api_key type: string type: object description: "Problem response. Possible codes: invalid_api_key." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "403": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - insufficient_scope type: string status: enum: - 403 type: number title: enum: - Insufficient scope type: string type: enum: - https://blank.build/docs/reference/errors#insufficient_scope type: string type: object description: "Problem response. Possible codes: insufficient_scope." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - operation_not_found type: string status: enum: - 404 type: number title: enum: - Operation not found type: string type: enum: - https://blank.build/docs/reference/errors#operation_not_found type: string type: object description: "Problem response. Possible codes: operation_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string security: - BlankApiKey: [] summary: Get an asynchronous operation tags: - Operations /prediction-intents: post: description: Creates a short-lived, single-use message for an end user's wallet to sign. The API key identifies the server-side integration and cannot replace the wallet signature. operationId: createDelegatedPredictionIntent parameters: - in: header name: idempotency-key required: true schema: example: launch-20260809-01 maxLength: 128 minLength: 8 pattern: ^[\x21-\x7E]+$ type: string requestBody: content: application/json: schema: $ref: "#/components/schemas/PredictionSubmission" required: true responses: "201": content: application/json: schema: $ref: "#/components/schemas/DelegatedPredictionIntent" description: The exact UTF-8 message the end user's wallet must sign. "400": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - malformed_json type: string status: enum: - 400 type: number title: enum: - Malformed JSON type: string type: enum: - https://blank.build/docs/reference/errors#malformed_json type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - idempotency_key_invalid type: string status: enum: - 400 type: number title: enum: - Invalid idempotency key type: string type: enum: - https://blank.build/docs/reference/errors#idempotency_key_invalid type: string type: object description: "Problem response. Possible codes: idempotency_key_invalid, malformed_json." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "401": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - invalid_api_key type: string status: enum: - 401 type: number title: enum: - Invalid API key type: string type: enum: - https://blank.build/docs/reference/errors#invalid_api_key type: string type: object description: "Problem response. Possible codes: invalid_api_key." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "403": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - insufficient_scope type: string status: enum: - 403 type: number title: enum: - Insufficient scope type: string type: enum: - https://blank.build/docs/reference/errors#insufficient_scope type: string type: object description: "Problem response. Possible codes: insufficient_scope." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_round_not_found type: string status: enum: - 404 type: number title: enum: - Prediction round not found type: string type: enum: - https://blank.build/docs/reference/errors#prediction_round_not_found type: string type: object description: "Problem response. Possible codes: prediction_round_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "409": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_round_not_open type: string status: enum: - 409 type: number title: enum: - Prediction round not open type: string type: enum: - https://blank.build/docs/reference/errors#prediction_round_not_open type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_token_not_enabled type: string status: enum: - 409 type: number title: enum: - Predictions not enabled type: string type: enum: - https://blank.build/docs/reference/errors#prediction_token_not_enabled type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - idempotency_key_reused type: string status: enum: - 409 type: number title: enum: - Idempotency key reused type: string type: enum: - https://blank.build/docs/reference/errors#idempotency_key_reused type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - idempotency_request_in_progress type: string status: enum: - 409 type: number title: enum: - Idempotency request in progress type: string type: enum: - https://blank.build/docs/reference/errors#idempotency_request_in_progress type: string type: object description: "Problem response. Possible codes: idempotency_key_reused, idempotency_request_in_progress, prediction_round_not_open, prediction_token_not_enabled." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "413": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - request_body_too_large type: string status: enum: - 413 type: number title: enum: - Request body too large type: string type: enum: - https://blank.build/docs/reference/errors#request_body_too_large type: string type: object description: "Problem response. Possible codes: request_body_too_large." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "415": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - unsupported_content_type type: string status: enum: - 415 type: number title: enum: - Unsupported content type type: string type: enum: - https://blank.build/docs/reference/errors#unsupported_content_type type: string type: object description: "Problem response. Possible codes: unsupported_content_type." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_price_out_of_range type: string status: enum: - 422 type: number title: enum: - Prediction price out of range type: string type: enum: - https://blank.build/docs/reference/errors#prediction_price_out_of_range type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: prediction_price_out_of_range, validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string security: - BlankApiKey: [] summary: Prepare a delegated prediction tags: - Predictions /predictions: post: description: Creates one immutable prediction for the API key account after finalized eligibility verification. operationId: createPrediction parameters: - in: header name: idempotency-key required: true schema: example: launch-20260809-01 maxLength: 128 minLength: 8 pattern: ^[\x21-\x7E]+$ type: string requestBody: content: application/json: schema: $ref: "#/components/schemas/PredictionSubmission" required: true responses: "201": content: application/json: schema: $ref: "#/components/schemas/Prediction" description: The immutable prediction. "400": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - malformed_json type: string status: enum: - 400 type: number title: enum: - Malformed JSON type: string type: enum: - https://blank.build/docs/reference/errors#malformed_json type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - idempotency_key_invalid type: string status: enum: - 400 type: number title: enum: - Invalid idempotency key type: string type: enum: - https://blank.build/docs/reference/errors#idempotency_key_invalid type: string type: object description: "Problem response. Possible codes: idempotency_key_invalid, malformed_json." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "401": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - invalid_api_key type: string status: enum: - 401 type: number title: enum: - Invalid API key type: string type: enum: - https://blank.build/docs/reference/errors#invalid_api_key type: string type: object description: "Problem response. Possible codes: invalid_api_key." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "403": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_wallet_mismatch type: string status: enum: - 403 type: number title: enum: - Prediction wallet mismatch type: string type: enum: - https://blank.build/docs/reference/errors#prediction_wallet_mismatch type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - insufficient_scope type: string status: enum: - 403 type: number title: enum: - Insufficient scope type: string type: enum: - https://blank.build/docs/reference/errors#insufficient_scope type: string type: object description: "Problem response. Possible codes: insufficient_scope, prediction_wallet_mismatch." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_round_not_found type: string status: enum: - 404 type: number title: enum: - Prediction round not found type: string type: enum: - https://blank.build/docs/reference/errors#prediction_round_not_found type: string type: object description: "Problem response. Possible codes: prediction_round_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "409": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_round_not_open type: string status: enum: - 409 type: number title: enum: - Prediction round not open type: string type: enum: - https://blank.build/docs/reference/errors#prediction_round_not_open type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_token_not_enabled type: string status: enum: - 409 type: number title: enum: - Predictions not enabled type: string type: enum: - https://blank.build/docs/reference/errors#prediction_token_not_enabled type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_wallet_not_verified type: string status: enum: - 409 type: number title: enum: - Wallet not verified type: string type: enum: - https://blank.build/docs/reference/errors#prediction_wallet_not_verified type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_username_required type: string status: enum: - 409 type: number title: enum: - Username required type: string type: enum: - https://blank.build/docs/reference/errors#prediction_username_required type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_insufficient_balance type: string status: enum: - 409 type: number title: enum: - Insufficient balance type: string type: enum: - https://blank.build/docs/reference/errors#prediction_insufficient_balance type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_already_submitted type: string status: enum: - 409 type: number title: enum: - Prediction already submitted type: string type: enum: - https://blank.build/docs/reference/errors#prediction_already_submitted type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - idempotency_key_reused type: string status: enum: - 409 type: number title: enum: - Idempotency key reused type: string type: enum: - https://blank.build/docs/reference/errors#idempotency_key_reused type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - idempotency_request_in_progress type: string status: enum: - 409 type: number title: enum: - Idempotency request in progress type: string type: enum: - https://blank.build/docs/reference/errors#idempotency_request_in_progress type: string type: object description: "Problem response. Possible codes: idempotency_key_reused, idempotency_request_in_progress, prediction_already_submitted, prediction_insufficient_balance, prediction_round_not_open, prediction_token_not_enabled, prediction_username_required, prediction_wallet_not_verified." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "413": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - request_body_too_large type: string status: enum: - 413 type: number title: enum: - Request body too large type: string type: enum: - https://blank.build/docs/reference/errors#request_body_too_large type: string type: object description: "Problem response. Possible codes: request_body_too_large." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "415": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - unsupported_content_type type: string status: enum: - 415 type: number title: enum: - Unsupported content type type: string type: enum: - https://blank.build/docs/reference/errors#unsupported_content_type type: string type: object description: "Problem response. Possible codes: unsupported_content_type." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_price_out_of_range type: string status: enum: - 422 type: number title: enum: - Prediction price out of range type: string type: enum: - https://blank.build/docs/reference/errors#prediction_price_out_of_range type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: prediction_price_out_of_range, validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_balance_unavailable type: string status: enum: - 503 type: number title: enum: - Balance unavailable type: string type: enum: - https://blank.build/docs/reference/errors#prediction_balance_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, prediction_balance_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string security: - BlankApiKey: [] summary: Submit a price prediction tags: - Predictions /predictions/{predictionId}: get: description: Returns the exact immutable prediction only to its owner. operationId: getOwnedPrediction parameters: - in: path name: predictionId required: true schema: format: uuid type: string responses: "200": content: application/json: schema: $ref: "#/components/schemas/Prediction" description: Owned prediction. "401": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - invalid_api_key type: string status: enum: - 401 type: number title: enum: - Invalid API key type: string type: enum: - https://blank.build/docs/reference/errors#invalid_api_key type: string type: object description: "Problem response. Possible codes: invalid_api_key." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "403": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - insufficient_scope type: string status: enum: - 403 type: number title: enum: - Insufficient scope type: string type: enum: - https://blank.build/docs/reference/errors#insufficient_scope type: string type: object description: "Problem response. Possible codes: insufficient_scope." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_not_found type: string status: enum: - 404 type: number title: enum: - Prediction not found type: string type: enum: - https://blank.build/docs/reference/errors#prediction_not_found type: string type: object description: "Problem response. Possible codes: prediction_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string security: - BlankApiKey: [] summary: Get an owned prediction tags: - Predictions /presales: get: description: Lists public presale state newest-first. operationId: listPresales parameters: - in: query name: cursor required: false schema: example: eyJ2IjoxLCJzb3J0IjpbIjIwMjYtMDgtMDlUMDA6MDA6MDBaIl19 maxLength: 2048 minLength: 16 pattern: ^[A-Za-z0-9_-]+$ type: string - in: query name: limit required: false schema: default: 50 pattern: ^[1-9][0-9]*$ type: string responses: "200": content: application/json: schema: $ref: "#/components/schemas/PresaleCollection" description: Presale page. "304": description: Not modified. The current ETag matched If-None-Match. "400": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - cursor_invalid type: string status: enum: - 400 type: number title: enum: - Invalid cursor type: string type: enum: - https://blank.build/docs/reference/errors#cursor_invalid type: string type: object description: "Problem response. Possible codes: cursor_invalid." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string summary: List presales tags: - Presales /presales/{id}: get: description: Returns public presale state without custody internals. operationId: getPresale parameters: - in: path name: id required: true schema: format: uuid type: string responses: "200": content: application/json: schema: $ref: "#/components/schemas/Presale" description: Presale state. "304": description: Not modified. The current ETag matched If-None-Match. "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - presale_not_found type: string status: enum: - 404 type: number title: enum: - Presale not found type: string type: enum: - https://blank.build/docs/reference/errors#presale_not_found type: string type: object description: "Problem response. Possible codes: presale_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string summary: Get a presale tags: - Presales /presales/{id}/participation: get: description: Returns participation only for the API key pinned wallet. operationId: getPresaleParticipation parameters: - in: path name: id required: true schema: format: uuid type: string responses: "200": content: application/json: schema: $ref: "#/components/schemas/PresaleParticipant" description: Owned participant state. "401": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - invalid_api_key type: string status: enum: - 401 type: number title: enum: - Invalid API key type: string type: enum: - https://blank.build/docs/reference/errors#invalid_api_key type: string type: object description: "Problem response. Possible codes: invalid_api_key." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "403": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - insufficient_scope type: string status: enum: - 403 type: number title: enum: - Insufficient scope type: string type: enum: - https://blank.build/docs/reference/errors#insufficient_scope type: string type: object description: "Problem response. Possible codes: insufficient_scope." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - presale_participation_not_found type: string status: enum: - 404 type: number title: enum: - Presale participation not found type: string type: enum: - https://blank.build/docs/reference/errors#presale_participation_not_found type: string type: object description: "Problem response. Possible codes: presale_participation_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string security: - BlankApiKey: [] summary: Get owned presale participation tags: - Presales /solana/manifest: get: description: Returns the v2 program addresses, public IDL URLs, and transaction limits for the active environment. operationId: getSolanaManifest responses: "200": content: application/json: schema: $ref: "#/components/schemas/SolanaManifest" description: The active Solana integration manifest. "304": description: Not modified. The current ETag matched If-None-Match. "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - manifest_unavailable type: string status: enum: - 503 type: number title: enum: - Manifest unavailable type: string type: enum: - https://blank.build/docs/reference/errors#manifest_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, manifest_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string summary: Get the Solana integration manifest tags: - System /tokens: get: description: Lists visible tokens in reverse launch order with signed cursor pagination and allowlisted filters. operationId: listTokens parameters: - in: query name: cursor required: false schema: example: eyJ2IjoxLCJzb3J0IjpbIjIwMjYtMDgtMDlUMDA6MDA6MDBaIl19 maxLength: 2048 minLength: 16 pattern: ^[A-Za-z0-9_-]+$ type: string - in: query name: limit required: false schema: default: 50 pattern: ^[1-9][0-9]*$ type: string - in: query name: status required: false schema: enum: - pending - pending_launch_init - pending_escrows - pending_finalization - bonding - pre_raise_pending - pre_raising - pre_raise_settling - pre_raise_refunding - pre_raise_failed - graduating_migration_pending - graduated - graduation_failed - expired - cancelled - failed type: string - in: query name: launchType required: false schema: enum: - dbc - pre_raise type: string responses: "200": content: application/json: schema: $ref: "#/components/schemas/TokenCollection" description: A stable cursor page of tokens. "304": description: Not modified. The current ETag matched If-None-Match. "400": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - cursor_invalid type: string status: enum: - 400 type: number title: enum: - Invalid cursor type: string type: enum: - https://blank.build/docs/reference/errors#cursor_invalid type: string type: object description: "Problem response. Possible codes: cursor_invalid." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - token_index_unavailable type: string status: enum: - 503 type: number title: enum: - Token index unavailable type: string type: enum: - https://blank.build/docs/reference/errors#token_index_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, rate_limit_unavailable, token_index_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string summary: List tokens tags: - Tokens /tokens/{mint}: get: description: Returns the public, allowlisted representation of one visible token. operationId: getToken parameters: - in: path name: mint required: true schema: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string responses: "200": content: application/json: schema: $ref: "#/components/schemas/Token" description: The token resource. "304": description: Not modified. The current ETag matched If-None-Match. "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - token_not_found type: string status: enum: - 404 type: number title: enum: - Token not found type: string type: enum: - https://blank.build/docs/reference/errors#token_not_found type: string type: object description: "Problem response. Possible codes: token_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - token_index_unavailable type: string status: enum: - 503 type: number title: enum: - Token index unavailable type: string type: enum: - https://blank.build/docs/reference/errors#token_index_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, rate_limit_unavailable, token_index_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string summary: Get a token tags: - Tokens /tokens/{mint}/candles: get: description: Returns at most 1,000 indexed OHLCV points for the required time range and interval. operationId: listTokenCandles parameters: - in: path name: mint required: true schema: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string - in: query name: from required: true schema: format: date-time type: string - in: query name: to required: true schema: format: date-time type: string - in: query name: interval required: true schema: enum: - 1m - 5m - 15m - 1h - 4h - 1d type: string responses: "200": content: application/json: schema: $ref: "#/components/schemas/CandleSeries" description: The bounded OHLCV series. "304": description: Not modified. The current ETag matched If-None-Match. "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - token_not_found type: string status: enum: - 404 type: number title: enum: - Token not found type: string type: enum: - https://blank.build/docs/reference/errors#token_not_found type: string type: object description: "Problem response. Possible codes: token_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - market_time_range_invalid type: string status: enum: - 422 type: number title: enum: - Invalid market time range type: string type: enum: - https://blank.build/docs/reference/errors#market_time_range_invalid type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: market_time_range_invalid, validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - market_data_unavailable type: string status: enum: - 503 type: number title: enum: - Market data unavailable type: string type: enum: - https://blank.build/docs/reference/errors#market_data_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, market_data_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string summary: List token candles tags: - Market data /tokens/{mint}/fee-distributions: get: description: Lists indexed fee distributions newest-first with a query-bound cursor. operationId: listTokenFeeDistributions parameters: - in: path name: mint required: true schema: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string - in: query name: cursor required: false schema: example: eyJ2IjoxLCJzb3J0IjpbIjIwMjYtMDgtMDlUMDA6MDA6MDBaIl19 maxLength: 2048 minLength: 16 pattern: ^[A-Za-z0-9_-]+$ type: string - in: query name: limit required: false schema: default: 50 pattern: ^[1-9][0-9]*$ type: string responses: "200": content: application/json: schema: $ref: "#/components/schemas/FeeDistributionCollection" description: Fee distribution page. "400": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - cursor_invalid type: string status: enum: - 400 type: number title: enum: - Invalid cursor type: string type: enum: - https://blank.build/docs/reference/errors#cursor_invalid type: string type: object description: "Problem response. Possible codes: cursor_invalid." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "401": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - invalid_api_key type: string status: enum: - 401 type: number title: enum: - Invalid API key type: string type: enum: - https://blank.build/docs/reference/errors#invalid_api_key type: string type: object description: "Problem response. Possible codes: invalid_api_key." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "403": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - insufficient_scope type: string status: enum: - 403 type: number title: enum: - Insufficient scope type: string type: enum: - https://blank.build/docs/reference/errors#insufficient_scope type: string type: object description: "Problem response. Possible codes: insufficient_scope." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - token_not_found type: string status: enum: - 404 type: number title: enum: - Token not found type: string type: enum: - https://blank.build/docs/reference/errors#token_not_found type: string type: object description: "Problem response. Possible codes: token_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string security: - BlankApiKey: [] summary: List token fee distributions tags: - Fees /tokens/{mint}/fees: get: description: Returns the current indexed fee policy and distribution totals. operationId: getTokenFeeState parameters: - in: path name: mint required: true schema: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string responses: "200": content: application/json: schema: $ref: "#/components/schemas/FeeState" description: Current fee state. "401": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - invalid_api_key type: string status: enum: - 401 type: number title: enum: - Invalid API key type: string type: enum: - https://blank.build/docs/reference/errors#invalid_api_key type: string type: object description: "Problem response. Possible codes: invalid_api_key." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "403": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - insufficient_scope type: string status: enum: - 403 type: number title: enum: - Insufficient scope type: string type: enum: - https://blank.build/docs/reference/errors#insufficient_scope type: string type: object description: "Problem response. Possible codes: insufficient_scope." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - token_not_found type: string status: enum: - 404 type: number title: enum: - Token not found type: string type: enum: - https://blank.build/docs/reference/errors#token_not_found type: string type: object description: "Problem response. Possible codes: token_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string security: - BlankApiKey: [] summary: Get token fee state tags: - Fees /tokens/{mint}/holders: get: description: Returns the latest indexed holder count with its source, slot, and observation time. operationId: getTokenHolderStats parameters: - in: path name: mint required: true schema: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string responses: "200": content: application/json: schema: $ref: "#/components/schemas/HolderStats" description: Latest holder statistics. "304": description: Not modified. The current ETag matched If-None-Match. "404": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - token_not_found type: string status: enum: - 404 type: number title: enum: - Token not found type: string type: enum: - https://blank.build/docs/reference/errors#token_not_found type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - holder_stats_not_found type: string status: enum: - 404 type: number title: enum: - Holder statistics not found type: string type: enum: - https://blank.build/docs/reference/errors#holder_stats_not_found type: string type: object description: "Problem response. Possible codes: holder_stats_not_found, token_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - market_data_unavailable type: string status: enum: - 503 type: number title: enum: - Market data unavailable type: string type: enum: - https://blank.build/docs/reference/errors#market_data_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, market_data_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string summary: Get token holder statistics tags: - Market data /tokens/{mint}/market: get: description: Returns the indexed price, market cap, liquidity, supply, holders, freshness, and provenance. operationId: getTokenMarketSnapshot parameters: - in: path name: mint required: true schema: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string responses: "200": content: application/json: schema: $ref: "#/components/schemas/MarketSnapshot" description: The current indexed market snapshot. "304": description: Not modified. The current ETag matched If-None-Match. "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - token_not_found type: string status: enum: - 404 type: number title: enum: - Token not found type: string type: enum: - https://blank.build/docs/reference/errors#token_not_found type: string type: object description: "Problem response. Possible codes: token_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - market_data_unavailable type: string status: enum: - 503 type: number title: enum: - Market data unavailable type: string type: enum: - https://blank.build/docs/reference/errors#market_data_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, market_data_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string summary: Get a token market snapshot tags: - Market data /tokens/{mint}/prediction-rounds: get: description: Lists price-prediction rounds newest-first. operationId: listPredictionRounds parameters: - in: path name: mint required: true schema: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string - in: query name: cursor required: false schema: example: eyJ2IjoxLCJzb3J0IjpbIjIwMjYtMDgtMDlUMDA6MDA6MDBaIl19 maxLength: 2048 minLength: 16 pattern: ^[A-Za-z0-9_-]+$ type: string - in: query name: limit required: false schema: default: 50 pattern: ^[1-9][0-9]*$ type: string responses: "200": content: application/json: schema: $ref: "#/components/schemas/PredictionRoundCollection" description: Prediction round page. "304": description: Not modified. The current ETag matched If-None-Match. "400": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - cursor_invalid type: string status: enum: - 400 type: number title: enum: - Invalid cursor type: string type: enum: - https://blank.build/docs/reference/errors#cursor_invalid type: string type: object description: "Problem response. Possible codes: cursor_invalid." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_token_not_enabled type: string status: enum: - 404 type: number title: enum: - Predictions not enabled type: string type: enum: - https://blank.build/docs/reference/errors#prediction_token_not_enabled type: string type: object description: "Problem response. Possible codes: prediction_token_not_enabled." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string summary: List prediction rounds tags: - Predictions /tokens/{mint}/prediction-rounds/{roundId}: get: description: Returns public round state with settlement price only after settlement. operationId: getPredictionRound parameters: - in: path name: mint required: true schema: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string - in: path name: roundId required: true schema: format: uuid type: string responses: "200": content: application/json: schema: $ref: "#/components/schemas/PredictionRound" description: Prediction round state. "304": description: Not modified. The current ETag matched If-None-Match. "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_round_not_found type: string status: enum: - 404 type: number title: enum: - Prediction round not found type: string type: enum: - https://blank.build/docs/reference/errors#prediction_round_not_found type: string type: object description: "Problem response. Possible codes: prediction_round_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string summary: Get a prediction round tags: - Predictions /tokens/{mint}/prediction-rounds/{roundId}/eligibility: get: description: Evaluates the pinned wallet against finalized chain state. operationId: getPredictionEligibility parameters: - in: path name: mint required: true schema: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string - in: path name: roundId required: true schema: format: uuid type: string responses: "200": content: application/json: schema: $ref: "#/components/schemas/PredictionEligibility" description: Current eligibility evidence. "401": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - invalid_api_key type: string status: enum: - 401 type: number title: enum: - Invalid API key type: string type: enum: - https://blank.build/docs/reference/errors#invalid_api_key type: string type: object description: "Problem response. Possible codes: invalid_api_key." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "403": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - insufficient_scope type: string status: enum: - 403 type: number title: enum: - Insufficient scope type: string type: enum: - https://blank.build/docs/reference/errors#insufficient_scope type: string type: object description: "Problem response. Possible codes: insufficient_scope." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_round_not_found type: string status: enum: - 404 type: number title: enum: - Prediction round not found type: string type: enum: - https://blank.build/docs/reference/errors#prediction_round_not_found type: string type: object description: "Problem response. Possible codes: prediction_round_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_balance_unavailable type: string status: enum: - 503 type: number title: enum: - Balance unavailable type: string type: enum: - https://blank.build/docs/reference/errors#prediction_balance_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, prediction_balance_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string security: - BlankApiKey: [] summary: Evaluate prediction eligibility tags: - Predictions /tokens/{mint}/prediction-rounds/{roundId}/predictions: get: description: Returns aggregate participation before lock and exact entries only after the durable lock transition. operationId: listRoundPredictions parameters: - in: path name: mint required: true schema: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string - in: path name: roundId required: true schema: format: uuid type: string responses: "200": content: application/json: schema: $ref: "#/components/schemas/PredictionList" description: Privacy-aware prediction list. "304": description: Not modified. The current ETag matched If-None-Match. "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_round_not_found type: string status: enum: - 404 type: number title: enum: - Prediction round not found type: string type: enum: - https://blank.build/docs/reference/errors#prediction_round_not_found type: string type: object description: "Problem response. Possible codes: prediction_round_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string summary: List round predictions tags: - Predictions /tokens/{mint}/prediction-rounds/{roundId}/standings: get: description: Returns standings only once the round has durably locked. operationId: listPredictionStandings parameters: - in: path name: mint required: true schema: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string - in: path name: roundId required: true schema: format: uuid type: string responses: "200": content: application/json: schema: $ref: "#/components/schemas/PredictionStandings" description: Prediction standings. "304": description: Not modified. The current ETag matched If-None-Match. "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_round_not_found type: string status: enum: - 404 type: number title: enum: - Prediction round not found type: string type: enum: - https://blank.build/docs/reference/errors#prediction_round_not_found type: string type: object description: "Problem response. Possible codes: prediction_round_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "409": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - prediction_exact_values_locked type: string status: enum: - 409 type: number title: enum: - Exact predictions are locked type: string type: enum: - https://blank.build/docs/reference/errors#prediction_exact_values_locked type: string type: object description: "Problem response. Possible codes: prediction_exact_values_locked." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string summary: List prediction standings tags: - Predictions /tokens/{mint}/staking: get: description: Returns the public indexed staking pool state and freshness evidence. operationId: getStakingPool parameters: - in: path name: mint required: true schema: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string responses: "200": content: application/json: schema: $ref: "#/components/schemas/StakingPool" description: Staking pool state. "304": description: Not modified. The current ETag matched If-None-Match. "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - staking_pool_not_found type: string status: enum: - 404 type: number title: enum: - Staking pool not found type: string type: enum: - https://blank.build/docs/reference/errors#staking_pool_not_found type: string type: object description: "Problem response. Possible codes: staking_pool_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string summary: Get token staking state tags: - Staking /tokens/{mint}/staking/leaderboard: get: description: Returns at most the top 100 wallets ordered by weighted stake. operationId: listStakingLeaderboard parameters: - in: path name: mint required: true schema: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string responses: "200": content: application/json: schema: $ref: "#/components/schemas/StakingLeaderboard" description: Bounded staking leaderboard. "304": description: Not modified. The current ETag matched If-None-Match. "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - staking_pool_not_found type: string status: enum: - 404 type: number title: enum: - Staking pool not found type: string type: enum: - https://blank.build/docs/reference/errors#staking_pool_not_found type: string type: object description: "Problem response. Possible codes: staking_pool_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string summary: List staking leaders tags: - Staking /tokens/{mint}/staking/positions: get: description: Lists only positions owned by the API key pinned wallet. operationId: listOwnedStakingPositions parameters: - in: path name: mint required: true schema: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string - in: query name: cursor required: false schema: example: eyJ2IjoxLCJzb3J0IjpbIjIwMjYtMDgtMDlUMDA6MDA6MDBaIl19 maxLength: 2048 minLength: 16 pattern: ^[A-Za-z0-9_-]+$ type: string - in: query name: limit required: false schema: default: 50 pattern: ^[1-9][0-9]*$ type: string responses: "200": content: application/json: schema: $ref: "#/components/schemas/StakingPositionCollection" description: Owned staking position page. "400": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - cursor_invalid type: string status: enum: - 400 type: number title: enum: - Invalid cursor type: string type: enum: - https://blank.build/docs/reference/errors#cursor_invalid type: string type: object description: "Problem response. Possible codes: cursor_invalid." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "401": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - invalid_api_key type: string status: enum: - 401 type: number title: enum: - Invalid API key type: string type: enum: - https://blank.build/docs/reference/errors#invalid_api_key type: string type: object description: "Problem response. Possible codes: invalid_api_key." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "403": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - insufficient_scope type: string status: enum: - 403 type: number title: enum: - Insufficient scope type: string type: enum: - https://blank.build/docs/reference/errors#insufficient_scope type: string type: object description: "Problem response. Possible codes: insufficient_scope." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - staking_pool_not_found type: string status: enum: - 404 type: number title: enum: - Staking pool not found type: string type: enum: - https://blank.build/docs/reference/errors#staking_pool_not_found type: string type: object description: "Problem response. Possible codes: staking_pool_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string security: - BlankApiKey: [] summary: List owned staking positions tags: - Staking /tokens/{mint}/trades: get: description: Lists indexed trades newest-first with a query-bound signed cursor. operationId: listTokenTrades parameters: - in: path name: mint required: true schema: example: "11111111111111111111111111111111" pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ type: string - in: query name: cursor required: false schema: example: eyJ2IjoxLCJzb3J0IjpbIjIwMjYtMDgtMDlUMDA6MDA6MDBaIl19 maxLength: 2048 minLength: 16 pattern: ^[A-Za-z0-9_-]+$ type: string - in: query name: limit required: false schema: default: 50 pattern: ^[1-9][0-9]*$ type: string responses: "200": content: application/json: schema: $ref: "#/components/schemas/TradeCollection" description: A stable cursor page of token trades. "304": description: Not modified. The current ETag matched If-None-Match. "400": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - cursor_invalid type: string status: enum: - 400 type: number title: enum: - Invalid cursor type: string type: enum: - https://blank.build/docs/reference/errors#cursor_invalid type: string type: object description: "Problem response. Possible codes: cursor_invalid." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - token_not_found type: string status: enum: - 404 type: number title: enum: - Token not found type: string type: enum: - https://blank.build/docs/reference/errors#token_not_found type: string type: object description: "Problem response. Possible codes: token_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - market_data_unavailable type: string status: enum: - 503 type: number title: enum: - Market data unavailable type: string type: enum: - https://blank.build/docs/reference/errors#market_data_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, market_data_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string summary: List token trades tags: - Market data /transaction-intents/{intentId}: get: description: Returns a transaction intent owned by the API key account. operationId: getTransactionIntent parameters: - in: path name: intentId required: true schema: format: uuid type: string responses: "200": content: application/json: schema: $ref: "#/components/schemas/TransactionIntent" description: Owned transaction intent. "304": description: Not modified. The current ETag matched If-None-Match. "401": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - invalid_api_key type: string status: enum: - 401 type: number title: enum: - Invalid API key type: string type: enum: - https://blank.build/docs/reference/errors#invalid_api_key type: string type: object description: "Problem response. Possible codes: invalid_api_key." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "403": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - insufficient_scope type: string status: enum: - 403 type: number title: enum: - Insufficient scope type: string type: enum: - https://blank.build/docs/reference/errors#insufficient_scope type: string type: object description: "Problem response. Possible codes: insufficient_scope." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - transaction_intent_not_found type: string status: enum: - 404 type: number title: enum: - Transaction intent not found type: string type: enum: - https://blank.build/docs/reference/errors#transaction_intent_not_found type: string type: object description: "Problem response. Possible codes: transaction_intent_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string security: - BlankApiKey: [] summary: Get a transaction intent tags: - Transaction intents /transaction-intents/{intentId}/submissions: post: description: Verifies the exact prepared message and wallet signature, then durably queues the transaction for broadcast. operationId: submitTransactionIntent parameters: - in: path name: intentId required: true schema: format: uuid type: string - in: header name: idempotency-key required: true schema: example: launch-20260809-01 maxLength: 128 minLength: 8 pattern: ^[\x21-\x7E]+$ type: string - in: header name: if-match required: true schema: example: '"1"' pattern: ^"[1-9][0-9]*"$ type: string requestBody: content: application/json: schema: $ref: "#/components/schemas/TransactionIntentSubmission" required: true responses: "202": content: application/json: schema: $ref: "#/components/schemas/TransactionIntent" description: Verified transaction intent queued for broadcast. "400": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - precondition_invalid type: string status: enum: - 400 type: number title: enum: - Invalid precondition type: string type: enum: - https://blank.build/docs/reference/errors#precondition_invalid type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - malformed_json type: string status: enum: - 400 type: number title: enum: - Malformed JSON type: string type: enum: - https://blank.build/docs/reference/errors#malformed_json type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - idempotency_key_invalid type: string status: enum: - 400 type: number title: enum: - Invalid idempotency key type: string type: enum: - https://blank.build/docs/reference/errors#idempotency_key_invalid type: string type: object description: "Problem response. Possible codes: idempotency_key_invalid, malformed_json, precondition_invalid." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "401": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - invalid_api_key type: string status: enum: - 401 type: number title: enum: - Invalid API key type: string type: enum: - https://blank.build/docs/reference/errors#invalid_api_key type: string type: object description: "Problem response. Possible codes: invalid_api_key." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "403": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - insufficient_scope type: string status: enum: - 403 type: number title: enum: - Insufficient scope type: string type: enum: - https://blank.build/docs/reference/errors#insufficient_scope type: string type: object description: "Problem response. Possible codes: insufficient_scope." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - transaction_intent_not_found type: string status: enum: - 404 type: number title: enum: - Transaction intent not found type: string type: enum: - https://blank.build/docs/reference/errors#transaction_intent_not_found type: string type: object description: "Problem response. Possible codes: transaction_intent_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "409": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - transaction_intent_not_prepared type: string status: enum: - 409 type: number title: enum: - Transaction intent not prepared type: string type: enum: - https://blank.build/docs/reference/errors#transaction_intent_not_prepared type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - transaction_intent_expired type: string status: enum: - 409 type: number title: enum: - Transaction intent expired type: string type: enum: - https://blank.build/docs/reference/errors#transaction_intent_expired type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - idempotency_key_reused type: string status: enum: - 409 type: number title: enum: - Idempotency key reused type: string type: enum: - https://blank.build/docs/reference/errors#idempotency_key_reused type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - idempotency_request_in_progress type: string status: enum: - 409 type: number title: enum: - Idempotency request in progress type: string type: enum: - https://blank.build/docs/reference/errors#idempotency_request_in_progress type: string type: object description: "Problem response. Possible codes: idempotency_key_reused, idempotency_request_in_progress, transaction_intent_expired, transaction_intent_not_prepared." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "412": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - transaction_intent_version_conflict type: string status: enum: - 412 type: number title: enum: - Transaction intent version conflict type: string type: enum: - https://blank.build/docs/reference/errors#transaction_intent_version_conflict type: string type: object description: "Problem response. Possible codes: transaction_intent_version_conflict." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "413": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - request_body_too_large type: string status: enum: - 413 type: number title: enum: - Request body too large type: string type: enum: - https://blank.build/docs/reference/errors#request_body_too_large type: string type: object description: "Problem response. Possible codes: request_body_too_large." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "415": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - unsupported_content_type type: string status: enum: - 415 type: number title: enum: - Unsupported content type type: string type: enum: - https://blank.build/docs/reference/errors#unsupported_content_type type: string type: object description: "Problem response. Possible codes: unsupported_content_type." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - transaction_intent_tampered type: string status: enum: - 422 type: number title: enum: - Transaction intent tampered type: string type: enum: - https://blank.build/docs/reference/errors#transaction_intent_tampered type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - transaction_intent_wrong_signer type: string status: enum: - 422 type: number title: enum: - Transaction intent wrong signer type: string type: enum: - https://blank.build/docs/reference/errors#transaction_intent_wrong_signer type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - transaction_intent_invalid_signature type: string status: enum: - 422 type: number title: enum: - Transaction intent invalid signature type: string type: enum: - https://blank.build/docs/reference/errors#transaction_intent_invalid_signature type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: transaction_intent_invalid_signature, transaction_intent_tampered, transaction_intent_wrong_signer, validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "428": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - precondition_required type: string status: enum: - 428 type: number title: enum: - Precondition required type: string type: enum: - https://blank.build/docs/reference/errors#precondition_required type: string type: object description: "Problem response. Possible codes: precondition_required." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string security: - BlankApiKey: [] summary: Submit a signed transaction intent tags: - Transaction intents /webhook-deliveries/{deliveryId}/replays: post: description: Creates a fresh owned delivery for the same immutable event. operationId: replayWebhookDelivery parameters: - in: path name: deliveryId required: true schema: format: uuid type: string - in: header name: idempotency-key required: true schema: example: launch-20260809-01 maxLength: 128 minLength: 8 pattern: ^[\x21-\x7E]+$ type: string responses: "202": content: application/json: schema: $ref: "#/components/schemas/WebhookDelivery" description: Replayed delivery. "400": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - malformed_json type: string status: enum: - 400 type: number title: enum: - Malformed JSON type: string type: enum: - https://blank.build/docs/reference/errors#malformed_json type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - idempotency_key_invalid type: string status: enum: - 400 type: number title: enum: - Invalid idempotency key type: string type: enum: - https://blank.build/docs/reference/errors#idempotency_key_invalid type: string type: object description: "Problem response. Possible codes: idempotency_key_invalid, malformed_json." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "401": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - invalid_api_key type: string status: enum: - 401 type: number title: enum: - Invalid API key type: string type: enum: - https://blank.build/docs/reference/errors#invalid_api_key type: string type: object description: "Problem response. Possible codes: invalid_api_key." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "403": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - insufficient_scope type: string status: enum: - 403 type: number title: enum: - Insufficient scope type: string type: enum: - https://blank.build/docs/reference/errors#insufficient_scope type: string type: object description: "Problem response. Possible codes: insufficient_scope." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - webhook_delivery_not_found type: string status: enum: - 404 type: number title: enum: - Webhook delivery not found type: string type: enum: - https://blank.build/docs/reference/errors#webhook_delivery_not_found type: string type: object description: "Problem response. Possible codes: webhook_delivery_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "409": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - webhook_delivery_not_replayable type: string status: enum: - 409 type: number title: enum: - Webhook delivery not replayable type: string type: enum: - https://blank.build/docs/reference/errors#webhook_delivery_not_replayable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - webhook_delivery_replay_limit_reached type: string status: enum: - 409 type: number title: enum: - Webhook delivery replay limit reached type: string type: enum: - https://blank.build/docs/reference/errors#webhook_delivery_replay_limit_reached type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - idempotency_key_reused type: string status: enum: - 409 type: number title: enum: - Idempotency key reused type: string type: enum: - https://blank.build/docs/reference/errors#idempotency_key_reused type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - idempotency_request_in_progress type: string status: enum: - 409 type: number title: enum: - Idempotency request in progress type: string type: enum: - https://blank.build/docs/reference/errors#idempotency_request_in_progress type: string type: object description: "Problem response. Possible codes: idempotency_key_reused, idempotency_request_in_progress, webhook_delivery_not_replayable, webhook_delivery_replay_limit_reached." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "413": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - request_body_too_large type: string status: enum: - 413 type: number title: enum: - Request body too large type: string type: enum: - https://blank.build/docs/reference/errors#request_body_too_large type: string type: object description: "Problem response. Possible codes: request_body_too_large." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "415": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - unsupported_content_type type: string status: enum: - 415 type: number title: enum: - Unsupported content type type: string type: enum: - https://blank.build/docs/reference/errors#unsupported_content_type type: string type: object description: "Problem response. Possible codes: unsupported_content_type." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string security: - BlankApiKey: [] summary: Replay a webhook delivery tags: - Webhooks /webhook-endpoints: get: description: Lists owned webhook endpoints. operationId: listWebhookEndpoints parameters: - in: query name: cursor required: false schema: example: eyJ2IjoxLCJzb3J0IjpbIjIwMjYtMDgtMDlUMDA6MDA6MDBaIl19 maxLength: 2048 minLength: 16 pattern: ^[A-Za-z0-9_-]+$ type: string - in: query name: limit required: false schema: default: 50 pattern: ^[1-9][0-9]*$ type: string responses: "200": content: application/json: schema: $ref: "#/components/schemas/WebhookEndpointCollection" description: Webhook endpoint page. "400": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - cursor_invalid type: string status: enum: - 400 type: number title: enum: - Invalid cursor type: string type: enum: - https://blank.build/docs/reference/errors#cursor_invalid type: string type: object description: "Problem response. Possible codes: cursor_invalid." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "401": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - invalid_api_key type: string status: enum: - 401 type: number title: enum: - Invalid API key type: string type: enum: - https://blank.build/docs/reference/errors#invalid_api_key type: string type: object description: "Problem response. Possible codes: invalid_api_key." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "403": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - insufficient_scope type: string status: enum: - 403 type: number title: enum: - Insufficient scope type: string type: enum: - https://blank.build/docs/reference/errors#insufficient_scope type: string type: object description: "Problem response. Possible codes: insufficient_scope." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string security: - BlankApiKey: [] summary: List webhook endpoints tags: - Webhooks post: description: Creates an owned HTTPS endpoint and displays its signing secret once. operationId: createWebhookEndpoint parameters: - in: header name: idempotency-key required: true schema: example: launch-20260809-01 maxLength: 128 minLength: 8 pattern: ^[\x21-\x7E]+$ type: string requestBody: content: application/json: schema: $ref: "#/components/schemas/WebhookEndpointCreate" required: true responses: "201": content: application/json: schema: $ref: "#/components/schemas/WebhookEndpointWithSecret" description: Endpoint and one-time signing secret. "400": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - malformed_json type: string status: enum: - 400 type: number title: enum: - Malformed JSON type: string type: enum: - https://blank.build/docs/reference/errors#malformed_json type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - idempotency_key_invalid type: string status: enum: - 400 type: number title: enum: - Invalid idempotency key type: string type: enum: - https://blank.build/docs/reference/errors#idempotency_key_invalid type: string type: object description: "Problem response. Possible codes: idempotency_key_invalid, malformed_json." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "401": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - invalid_api_key type: string status: enum: - 401 type: number title: enum: - Invalid API key type: string type: enum: - https://blank.build/docs/reference/errors#invalid_api_key type: string type: object description: "Problem response. Possible codes: invalid_api_key." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "403": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - insufficient_scope type: string status: enum: - 403 type: number title: enum: - Insufficient scope type: string type: enum: - https://blank.build/docs/reference/errors#insufficient_scope type: string type: object description: "Problem response. Possible codes: insufficient_scope." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "409": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - webhook_endpoint_limit_reached type: string status: enum: - 409 type: number title: enum: - Webhook endpoint limit reached type: string type: enum: - https://blank.build/docs/reference/errors#webhook_endpoint_limit_reached type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - idempotency_key_reused type: string status: enum: - 409 type: number title: enum: - Idempotency key reused type: string type: enum: - https://blank.build/docs/reference/errors#idempotency_key_reused type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - idempotency_request_in_progress type: string status: enum: - 409 type: number title: enum: - Idempotency request in progress type: string type: enum: - https://blank.build/docs/reference/errors#idempotency_request_in_progress type: string type: object description: "Problem response. Possible codes: idempotency_key_reused, idempotency_request_in_progress, webhook_endpoint_limit_reached." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "413": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - request_body_too_large type: string status: enum: - 413 type: number title: enum: - Request body too large type: string type: enum: - https://blank.build/docs/reference/errors#request_body_too_large type: string type: object description: "Problem response. Possible codes: request_body_too_large." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "415": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - unsupported_content_type type: string status: enum: - 415 type: number title: enum: - Unsupported content type type: string type: enum: - https://blank.build/docs/reference/errors#unsupported_content_type type: string type: object description: "Problem response. Possible codes: unsupported_content_type." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - webhook_url_disallowed type: string status: enum: - 422 type: number title: enum: - Webhook URL disallowed type: string type: enum: - https://blank.build/docs/reference/errors#webhook_url_disallowed type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed, webhook_url_disallowed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string security: - BlankApiKey: [] summary: Create a webhook endpoint tags: - Webhooks /webhook-endpoints/{endpointId}: delete: description: Soft-deletes an owned endpoint and stops future fanout. operationId: deleteWebhookEndpoint parameters: - in: path name: endpointId required: true schema: format: uuid type: string - in: header name: idempotency-key required: true schema: example: launch-20260809-01 maxLength: 128 minLength: 8 pattern: ^[\x21-\x7E]+$ type: string - in: header name: if-match required: true schema: example: '"1"' pattern: ^"[1-9][0-9]*"$ type: string responses: "200": content: application/json: schema: $ref: "#/components/schemas/WebhookDeletion" description: Deletion receipt. "400": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - precondition_invalid type: string status: enum: - 400 type: number title: enum: - Invalid precondition type: string type: enum: - https://blank.build/docs/reference/errors#precondition_invalid type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - malformed_json type: string status: enum: - 400 type: number title: enum: - Malformed JSON type: string type: enum: - https://blank.build/docs/reference/errors#malformed_json type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - idempotency_key_invalid type: string status: enum: - 400 type: number title: enum: - Invalid idempotency key type: string type: enum: - https://blank.build/docs/reference/errors#idempotency_key_invalid type: string type: object description: "Problem response. Possible codes: idempotency_key_invalid, malformed_json, precondition_invalid." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "401": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - invalid_api_key type: string status: enum: - 401 type: number title: enum: - Invalid API key type: string type: enum: - https://blank.build/docs/reference/errors#invalid_api_key type: string type: object description: "Problem response. Possible codes: invalid_api_key." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "403": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - insufficient_scope type: string status: enum: - 403 type: number title: enum: - Insufficient scope type: string type: enum: - https://blank.build/docs/reference/errors#insufficient_scope type: string type: object description: "Problem response. Possible codes: insufficient_scope." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - webhook_endpoint_not_found type: string status: enum: - 404 type: number title: enum: - Webhook endpoint not found type: string type: enum: - https://blank.build/docs/reference/errors#webhook_endpoint_not_found type: string type: object description: "Problem response. Possible codes: webhook_endpoint_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "409": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - idempotency_key_reused type: string status: enum: - 409 type: number title: enum: - Idempotency key reused type: string type: enum: - https://blank.build/docs/reference/errors#idempotency_key_reused type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - idempotency_request_in_progress type: string status: enum: - 409 type: number title: enum: - Idempotency request in progress type: string type: enum: - https://blank.build/docs/reference/errors#idempotency_request_in_progress type: string type: object description: "Problem response. Possible codes: idempotency_key_reused, idempotency_request_in_progress." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "412": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - precondition_failed type: string status: enum: - 412 type: number title: enum: - Precondition failed type: string type: enum: - https://blank.build/docs/reference/errors#precondition_failed type: string type: object description: "Problem response. Possible codes: precondition_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "413": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - request_body_too_large type: string status: enum: - 413 type: number title: enum: - Request body too large type: string type: enum: - https://blank.build/docs/reference/errors#request_body_too_large type: string type: object description: "Problem response. Possible codes: request_body_too_large." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "415": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - unsupported_content_type type: string status: enum: - 415 type: number title: enum: - Unsupported content type type: string type: enum: - https://blank.build/docs/reference/errors#unsupported_content_type type: string type: object description: "Problem response. Possible codes: unsupported_content_type." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "428": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - precondition_required type: string status: enum: - 428 type: number title: enum: - Precondition required type: string type: enum: - https://blank.build/docs/reference/errors#precondition_required type: string type: object description: "Problem response. Possible codes: precondition_required." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string security: - BlankApiKey: [] summary: Delete a webhook endpoint tags: - Webhooks get: description: Returns an owned webhook endpoint. operationId: getWebhookEndpoint parameters: - in: path name: endpointId required: true schema: format: uuid type: string responses: "200": content: application/json: schema: $ref: "#/components/schemas/WebhookEndpoint" description: Webhook endpoint. "304": description: Not modified. The current ETag matched If-None-Match. "401": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - invalid_api_key type: string status: enum: - 401 type: number title: enum: - Invalid API key type: string type: enum: - https://blank.build/docs/reference/errors#invalid_api_key type: string type: object description: "Problem response. Possible codes: invalid_api_key." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "403": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - insufficient_scope type: string status: enum: - 403 type: number title: enum: - Insufficient scope type: string type: enum: - https://blank.build/docs/reference/errors#insufficient_scope type: string type: object description: "Problem response. Possible codes: insufficient_scope." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - webhook_endpoint_not_found type: string status: enum: - 404 type: number title: enum: - Webhook endpoint not found type: string type: enum: - https://blank.build/docs/reference/errors#webhook_endpoint_not_found type: string type: object description: "Problem response. Possible codes: webhook_endpoint_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string security: - BlankApiKey: [] summary: Get a webhook endpoint tags: - Webhooks patch: description: Updates an owned endpoint using optimistic concurrency. operationId: updateWebhookEndpoint parameters: - in: path name: endpointId required: true schema: format: uuid type: string - in: header name: idempotency-key required: true schema: example: launch-20260809-01 maxLength: 128 minLength: 8 pattern: ^[\x21-\x7E]+$ type: string - in: header name: if-match required: true schema: example: '"1"' pattern: ^"[1-9][0-9]*"$ type: string requestBody: content: application/json: schema: $ref: "#/components/schemas/WebhookEndpointUpdate" required: true responses: "200": content: application/json: schema: $ref: "#/components/schemas/WebhookEndpoint" description: Updated endpoint. "400": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - precondition_invalid type: string status: enum: - 400 type: number title: enum: - Invalid precondition type: string type: enum: - https://blank.build/docs/reference/errors#precondition_invalid type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - malformed_json type: string status: enum: - 400 type: number title: enum: - Malformed JSON type: string type: enum: - https://blank.build/docs/reference/errors#malformed_json type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - idempotency_key_invalid type: string status: enum: - 400 type: number title: enum: - Invalid idempotency key type: string type: enum: - https://blank.build/docs/reference/errors#idempotency_key_invalid type: string type: object description: "Problem response. Possible codes: idempotency_key_invalid, malformed_json, precondition_invalid." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "401": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - invalid_api_key type: string status: enum: - 401 type: number title: enum: - Invalid API key type: string type: enum: - https://blank.build/docs/reference/errors#invalid_api_key type: string type: object description: "Problem response. Possible codes: invalid_api_key." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "403": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - insufficient_scope type: string status: enum: - 403 type: number title: enum: - Insufficient scope type: string type: enum: - https://blank.build/docs/reference/errors#insufficient_scope type: string type: object description: "Problem response. Possible codes: insufficient_scope." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - webhook_endpoint_not_found type: string status: enum: - 404 type: number title: enum: - Webhook endpoint not found type: string type: enum: - https://blank.build/docs/reference/errors#webhook_endpoint_not_found type: string type: object description: "Problem response. Possible codes: webhook_endpoint_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "409": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - idempotency_key_reused type: string status: enum: - 409 type: number title: enum: - Idempotency key reused type: string type: enum: - https://blank.build/docs/reference/errors#idempotency_key_reused type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - idempotency_request_in_progress type: string status: enum: - 409 type: number title: enum: - Idempotency request in progress type: string type: enum: - https://blank.build/docs/reference/errors#idempotency_request_in_progress type: string type: object description: "Problem response. Possible codes: idempotency_key_reused, idempotency_request_in_progress." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "412": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - precondition_failed type: string status: enum: - 412 type: number title: enum: - Precondition failed type: string type: enum: - https://blank.build/docs/reference/errors#precondition_failed type: string type: object description: "Problem response. Possible codes: precondition_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "413": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - request_body_too_large type: string status: enum: - 413 type: number title: enum: - Request body too large type: string type: enum: - https://blank.build/docs/reference/errors#request_body_too_large type: string type: object description: "Problem response. Possible codes: request_body_too_large." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "415": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - unsupported_content_type type: string status: enum: - 415 type: number title: enum: - Unsupported content type type: string type: enum: - https://blank.build/docs/reference/errors#unsupported_content_type type: string type: object description: "Problem response. Possible codes: unsupported_content_type." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - webhook_url_disallowed type: string status: enum: - 422 type: number title: enum: - Webhook URL disallowed type: string type: enum: - https://blank.build/docs/reference/errors#webhook_url_disallowed type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed, webhook_url_disallowed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "428": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - precondition_required type: string status: enum: - 428 type: number title: enum: - Precondition required type: string type: enum: - https://blank.build/docs/reference/errors#precondition_required type: string type: object description: "Problem response. Possible codes: precondition_required." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string security: - BlankApiKey: [] summary: Update a webhook endpoint tags: - Webhooks /webhook-endpoints/{endpointId}/deliveries: get: description: Lists owned delivery state and bounded failure metadata. operationId: listWebhookDeliveries parameters: - in: path name: endpointId required: true schema: format: uuid type: string - in: query name: cursor required: false schema: example: eyJ2IjoxLCJzb3J0IjpbIjIwMjYtMDgtMDlUMDA6MDA6MDBaIl19 maxLength: 2048 minLength: 16 pattern: ^[A-Za-z0-9_-]+$ type: string - in: query name: limit required: false schema: default: 50 pattern: ^[1-9][0-9]*$ type: string - in: query name: status required: false schema: enum: - pending - processing - succeeded - retrying - dead_letter type: string responses: "200": content: application/json: schema: $ref: "#/components/schemas/WebhookDeliveryCollection" description: Webhook delivery page. "400": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - cursor_invalid type: string status: enum: - 400 type: number title: enum: - Invalid cursor type: string type: enum: - https://blank.build/docs/reference/errors#cursor_invalid type: string type: object description: "Problem response. Possible codes: cursor_invalid." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "401": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - invalid_api_key type: string status: enum: - 401 type: number title: enum: - Invalid API key type: string type: enum: - https://blank.build/docs/reference/errors#invalid_api_key type: string type: object description: "Problem response. Possible codes: invalid_api_key." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "403": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - insufficient_scope type: string status: enum: - 403 type: number title: enum: - Insufficient scope type: string type: enum: - https://blank.build/docs/reference/errors#insufficient_scope type: string type: object description: "Problem response. Possible codes: insufficient_scope." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - webhook_endpoint_not_found type: string status: enum: - 404 type: number title: enum: - Webhook endpoint not found type: string type: enum: - https://blank.build/docs/reference/errors#webhook_endpoint_not_found type: string type: object description: "Problem response. Possible codes: webhook_endpoint_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string security: - BlankApiKey: [] summary: List webhook deliveries tags: - Webhooks /webhook-endpoints/{endpointId}/secret-rotations: post: description: Rotates the secret with a bounded overlap and displays the new secret once. operationId: rotateWebhookSecret parameters: - in: path name: endpointId required: true schema: format: uuid type: string - in: header name: idempotency-key required: true schema: example: launch-20260809-01 maxLength: 128 minLength: 8 pattern: ^[\x21-\x7E]+$ type: string - in: header name: if-match required: true schema: example: '"1"' pattern: ^"[1-9][0-9]*"$ type: string requestBody: content: application/json: schema: $ref: "#/components/schemas/WebhookSecretRotation" required: true responses: "201": content: application/json: schema: $ref: "#/components/schemas/WebhookEndpointWithSecret" description: Endpoint and new one-time secret. "400": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - precondition_invalid type: string status: enum: - 400 type: number title: enum: - Invalid precondition type: string type: enum: - https://blank.build/docs/reference/errors#precondition_invalid type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - malformed_json type: string status: enum: - 400 type: number title: enum: - Malformed JSON type: string type: enum: - https://blank.build/docs/reference/errors#malformed_json type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - idempotency_key_invalid type: string status: enum: - 400 type: number title: enum: - Invalid idempotency key type: string type: enum: - https://blank.build/docs/reference/errors#idempotency_key_invalid type: string type: object description: "Problem response. Possible codes: idempotency_key_invalid, malformed_json, precondition_invalid." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "401": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - invalid_api_key type: string status: enum: - 401 type: number title: enum: - Invalid API key type: string type: enum: - https://blank.build/docs/reference/errors#invalid_api_key type: string type: object description: "Problem response. Possible codes: invalid_api_key." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "403": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - insufficient_scope type: string status: enum: - 403 type: number title: enum: - Insufficient scope type: string type: enum: - https://blank.build/docs/reference/errors#insufficient_scope type: string type: object description: "Problem response. Possible codes: insufficient_scope." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "404": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - webhook_endpoint_not_found type: string status: enum: - 404 type: number title: enum: - Webhook endpoint not found type: string type: enum: - https://blank.build/docs/reference/errors#webhook_endpoint_not_found type: string type: object description: "Problem response. Possible codes: webhook_endpoint_not_found." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "409": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - idempotency_key_reused type: string status: enum: - 409 type: number title: enum: - Idempotency key reused type: string type: enum: - https://blank.build/docs/reference/errors#idempotency_key_reused type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - idempotency_request_in_progress type: string status: enum: - 409 type: number title: enum: - Idempotency request in progress type: string type: enum: - https://blank.build/docs/reference/errors#idempotency_request_in_progress type: string type: object description: "Problem response. Possible codes: idempotency_key_reused, idempotency_request_in_progress." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "412": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - precondition_failed type: string status: enum: - 412 type: number title: enum: - Precondition failed type: string type: enum: - https://blank.build/docs/reference/errors#precondition_failed type: string type: object description: "Problem response. Possible codes: precondition_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "413": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - request_body_too_large type: string status: enum: - 413 type: number title: enum: - Request body too large type: string type: enum: - https://blank.build/docs/reference/errors#request_body_too_large type: string type: object description: "Problem response. Possible codes: request_body_too_large." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "415": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - unsupported_content_type type: string status: enum: - 415 type: number title: enum: - Unsupported content type type: string type: enum: - https://blank.build/docs/reference/errors#unsupported_content_type type: string type: object description: "Problem response. Possible codes: unsupported_content_type." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "422": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - validation_failed type: string status: enum: - 422 type: number title: enum: - Validation failed type: string type: enum: - https://blank.build/docs/reference/errors#validation_failed type: string type: object description: "Problem response. Possible codes: validation_failed." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "428": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - precondition_required type: string status: enum: - 428 type: number title: enum: - Precondition required type: string type: enum: - https://blank.build/docs/reference/errors#precondition_required type: string type: object description: "Problem response. Possible codes: precondition_required." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "429": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_exceeded type: string status: enum: - 429 type: number title: enum: - Rate limit exceeded type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_exceeded type: string type: object description: "Problem response. Possible codes: rate_limit_exceeded." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "500": content: application/problem+json: schema: allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - internal_error type: string status: enum: - 500 type: number title: enum: - Internal server error type: string type: enum: - https://blank.build/docs/reference/errors#internal_error type: string type: object description: "Problem response. Possible codes: internal_error." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string "503": content: application/problem+json: schema: oneOf: - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - rate_limit_unavailable type: string status: enum: - 503 type: number title: enum: - Rate limiting unavailable type: string type: enum: - https://blank.build/docs/reference/errors#rate_limit_unavailable type: string type: object - allOf: - $ref: "#/components/schemas/ProblemDetails" - properties: code: enum: - api_dependency_unavailable type: string status: enum: - 503 type: number title: enum: - API dependency unavailable type: string type: enum: - https://blank.build/docs/reference/errors#api_dependency_unavailable type: string type: object description: "Problem response. Possible codes: api_dependency_unavailable, rate_limit_unavailable." headers: Cache-Control: description: Error responses are private and never cached. required: true schema: description: Error responses are private and never cached. enum: - private, no-store type: string Retry-After: description: Minimum delay in seconds before a safe retry. required: true schema: description: Minimum delay in seconds before a safe retry. pattern: ^[0-9]+$ type: string Vary: description: The response varies by authorization context. required: true schema: description: The response varies by authorization context. enum: - Authorization type: string X-Blank-Api-Version: description: Public API major version. required: true schema: description: Public API major version. enum: - "2" type: string X-Duration-Ms: description: Server-side request duration in milliseconds. required: true schema: description: Server-side request duration in milliseconds. pattern: ^[0-9]+$ type: string X-Request-Id: description: Request identifier matching Problem Details requestId. required: true schema: description: Request identifier matching Problem Details requestId. type: string traceparent: description: W3C trace context for correlation. required: true schema: description: W3C trace context for correlation. type: string security: - BlankApiKey: [] summary: Rotate a webhook secret tags: - Webhooks servers: - description: Production url: https://api.blank.build/api/v2 tags: - description: Platform and Solana integration metadata. name: System - description: Current API-key identity. name: Identity - description: Token resources and management. name: Tokens - description: Price, trade, candle, liquidity, and holder data. name: Market data - description: Launch resources and transaction intents. name: Launches - description: Quotes and transaction intents. name: Trading - description: Pools, positions, and transaction intents. name: Staking - description: Fee state, distributions, and claim intents. name: Fees - description: Presale resources and participant actions. name: Presales - description: Prediction rounds, entries, and standings. name: Predictions - description: Asynchronous audience exports. name: Audience - description: Owned asynchronous operation status. name: Operations - description: Outbound webhook configuration and deliveries. name: Webhooks webhooks: blankEvent: post: operationId: receiveBlankWebhookEvent requestBody: content: application/json: schema: $ref: "#/components/schemas/WebhookCloudEvent" required: true responses: "200": description: The event was accepted. "204": description: The event was accepted without a body. summary: Receive a signed Blank CloudEvent