{"uid":"cap_tyFbHkUVHqyrD_KLzLvX8","slug":"market-data-integrity-attestation-f4acfe60","name":"Market Data Integrity Attestation","description":"Crypto Market Data Integrity Attestation for agents and trading systems. Validate caller-supplied crypto market observations for causal timing, freshness, gaps, sequencing, identity consistency, and cryptographic record hashes. Returns deterministic PASS/FAIL, safe_to_use, named checks, and attestation identity. Use before analytics, research, or trading workflows. No market data acquisition or redistribution; no trade recommendation.","url":"https://api.tradebot.devs.surf/v1/market-data-attestation?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"policy":{"type":"object","title":"AttestationPolicy","required":["max_age_ms","max_receive_lag_ms","require_sequence","require_identity_consistency","allowed_future_clock_skew_ms"],"properties":{"max_age_ms":{"type":"integer","title":"Max Age Ms","maximum":2678400000,"minimum":0},"require_sequence":{"type":"boolean","title":"Require Sequence"},"max_receive_lag_ms":{"type":"integer","title":"Max Receive Lag Ms","maximum":2678400000,"minimum":0},"expected_interval_ms":{"anyOf":[{"type":"integer","maximum":2678400000,"minimum":1},{"type":"null"}],"title":"Expected Interval Ms","default":null},"interval_tolerance_ms":{"anyOf":[{"type":"integer","maximum":2678400000,"minimum":0},{"type":"null"}],"title":"Interval Tolerance Ms","default":null},"allowed_future_clock_skew_ms":{"type":"integer","title":"Allowed Future Clock Skew Ms","maximum":86400000,"minimum":0},"require_identity_consistency":{"type":"boolean","title":"Require Identity Consistency"}},"additionalProperties":false},"dataset_id":{"type":"string","title":"Dataset Id","maxLength":128,"minLength":1},"observations":{"type":"array","items":{"type":"object","title":"Observation","required":["event_time_ms","received_time_ms"],"properties":{"identity":{"anyOf":[{"type":"string","maxLength":256,"minLength":1},{"type":"null"}],"title":"Identity","default":null},"sequence":{"anyOf":[{"type":"integer","maximum":9223372036854776000,"minimum":0},{"type":"null"}],"title":"Sequence","default":null},"event_time_ms":{"type":"integer","title":"Event Time Ms","maximum":9223372036854776000,"minimum":0},"payload_sha256":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}],"title":"Payload Sha256","default":null},"received_time_ms":{"type":"integer","title":"Received Time Ms","maximum":9223372036854776000,"minimum":0}},"additionalProperties":false},"title":"Observations","maxItems":512,"minItems":1},"source_label":{"type":"string","title":"Source Label","maxLength":128,"minLength":1}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cV5ocBmgaPtQsJUk-6rtZ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates caller-supplied crypto market observations for timing, freshness, sequencing, identity consistency, and cryptographic hash integrity, returning a deterministic PASS/FAIL attestation result.","exampleAgentPrompt":"Before I run my analytics pipeline, can you attest my BTC/USD market observations from dataset 'btcusd-feed-001' using a max age of 5000ms, max receive lag of 2000ms, with sequence and identity consistency required, and a clock skew tolerance of 500ms?","exampleUseCases":[{"title":"Pre-trade data freshness check","prompt":"Before placing any trades, validate my ETH/USDT order book observations from dataset 'ethusdt-live' — require them to be no older than 3000ms, max receive lag 1500ms, sequencing enforced, identity consistency on, and clock skew up to 250ms. Tell me if it's safe to use."},{"title":"Analytics pipeline data quality gate","prompt":"I'm about to kick off a crypto market analytics run on dataset 'multi-asset-2024-q1'. Attest these 50 observations for freshness (max age 60000ms), receive lag under 5000ms, expected interval of 1000ms with 200ms tolerance, and flag any identity inconsistencies or hash mismatches."},{"title":"Detect sequencing gaps in live feed","prompt":"Can you check my crypto market data feed 'coinbase-btc-feed' for any sequence gaps or out-of-order events? Use a policy with max age 10000ms, max receive lag 3000ms, require sequence enabled, identity consistency required, and allowed future clock skew of 500ms."}],"resultDescription":"Returns a deterministic PASS or FAIL verdict, a safe_to_use boolean, individual named check results (e.g. freshness, receive lag, sequencing, identity consistency, hash verification), and an attestation identity for auditability. No market data is redistributed or acquired.","failureModes":["FAIL returned when any observation exceeds max_age_ms or max_receive_lag_ms thresholds","FAIL on sequence gaps or out-of-order sequence numbers when require_sequence is true","FAIL on identity label inconsistencies when require_identity_consistency is true","FAIL on payload_sha256 mismatch if hashes are supplied","FAIL when event_time_ms is in the future beyond allowed_future_clock_skew_ms","Invalid input schema (missing required fields like event_time_ms or received_time_ms) returns a 4xx error","Exceeding 512 observations per request results in a validation error"],"whenToPreferThis":"Use this endpoint when you need a deterministic, auditable integrity check on caller-supplied crypto market data before downstream analytics, research, or trading workflows — especially when you need named, per-check results for causal timing, freshness, sequencing, and cryptographic hash verification. Prefer this over generic data validators when working specifically with time-series financial market observations that require strict sequencing and identity consistency guarantees.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:36:22.001Z","isFirstParty":false,"canonicalSlug":"market-data-integrity-attestation-f4acfe60"}