Api Endpoint

api.tradebot.devs.surf

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.

Open interactive test console

Offering

Provider
api.tradebot.devs.surf
Method
POST
Offering type
Api Endpoint
Transport type
http
Category
Security
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://api.tradebot.devs.surf/v1/market-data-attestation
MIME type
Not provided
First seen
2026-10-16T01:50:19.913Z
Last seen
Tags
market-data, data-quality, attestation, provenance, trading-agents

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.01 USDC
Atomic price: 10000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "10000",
    "payTo": "0x1bdd0cf6c2457765afeb717bc1e5d74b27d45a0f"
  }
]

Observed health

Status
Reachable
Latest latency
308 ms
Average latency
1124 ms
HTTP status
405
Last checked
Reachability
100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "body": {
      "additionalProperties": false,
      "properties": {
        "dataset_id": {
          "maxLength": 128,
          "minLength": 1,
          "title": "Dataset Id",
          "type": "string"
        },
        "observations": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "event_time_ms": {
                "maximum": 9223372036854776000,
                "minimum": 0,
                "title": "Event Time Ms",
                "type": "integer"
              },
              "identity": {
                "anyOf": [
                  {
                    "maxLength": 256,
                    "minLength": 1,
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Identity"
              },
              "payload_sha256": {
                "anyOf": [
                  {
                    "pattern": "^[0-9a-f]{64}$",
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Payload Sha256"
              },
              "received_time_ms": {
                "maximum": 9223372036854776000,
                "minimum": 0,
                "title": "Received Time Ms",
                "type": "integer"
              },
              "sequence": {
                "anyOf": [
                  {
                    "maximum": 9223372036854776000,
                    "minimum": 0,
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "title": "Sequence"
              }
            },
            "required": [
              "event_time_ms",
              "received_time_ms"
            ],
            "title": "Observation",
            "type": "object"
          },
          "maxItems": 512,
          "minItems": 1,
          "title": "Observations",
          "type": "array"
        },
        "policy": {
          "additionalProperties": false,
          "properties": {
            "allowed_future_clock_skew_ms": {
              "maximum": 86400000,
              "minimum": 0,
              "title": "Allowed Future Clock Skew Ms",
              "type": "integer"
            },
            "expected_interval_ms": {
              "anyOf": [
                {
                  "maximum": 2678400000,
                  "minimum": 1,
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Expected Interval Ms"
            },
            "interval_tolerance_ms": {
              "anyOf": [
                {
                  "maximum": 2678400000,
                  "minimum": 0,
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Interval Tolerance Ms"
            },
            "max_age_ms": {
              "maximum": 2678400000,
              "minimum": 0,
              "title": "Max Age Ms",
              "type": "integer"
            },
            "max_receive_lag_ms": {
              "maximum": 2678400000,
              "minimum": 0,
              "title": "Max Receive Lag Ms",
              "type": "integer"
            },
            "require_identity_consistency": {
              "title": "Require Identity Consistency",
              "type": "boolean"
            },
            "require_sequence": {
              "title": "Require Sequence",
              "type": "boolean"
            }
          },
          "required": [
            "max_age_ms",
            "max_receive_lag_ms",
            "require_sequence",
            "require_identity_consistency",
            "allowed_future_clock_skew_ms"
          ],
          "title": "AttestationPolicy",
          "type": "object"
        },
        "source_label": {
          "maxLength": 128,
          "minLength": 1,
          "title": "Source Label",
          "type": "string"
        }
      },
      "required": [
        "dataset_id",
        "source_label",
        "observations",
        "policy"
      ],
      "title": "MarketDataAttestationRequest",
      "type": "object"
    },
    "bodyType": {
      "enum": [
        "json",
        "form-data",
        "text"
      ],
      "type": "string"
    },
    "method": {
      "enum": [
        "POST",
        "PUT",
        "PATCH"
      ],
      "type": "string"
    },
    "type": {
      "const": "http",
      "type": "string"
    }
  },
  "required": [
    "type",
    "method",
    "bodyType",
    "body"
  ],
  "type": "object"
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "additionalProperties": false,
          "properties": {
            "dataset_id": {
              "maxLength": 128,
              "minLength": 1,
              "title": "Dataset Id",
              "type": "string"
            },
            "observations": {
              "items": {
                "additionalProperties": false,
                "properties": {
                  "event_time_ms": {
                    "maximum": 9223372036854776000,
                    "minimum": 0,
                    "title": "Event Time Ms",
                    "type": "integer"
                  },
                  "identity": {
                    "anyOf": [
                      {
                        "maxLength": 256,
                        "minLength": 1,
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "title": "Identity"
                  },
                  "payload_sha256": {
                    "anyOf": [
                      {
                        "pattern": "^[0-9a-f]{64}$",
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "title": "Payload Sha256"
                  },
                  "received_time_ms": {
                    "maximum": 9223372036854776000,
                    "minimum": 0,
                    "title": "Received Time Ms",
                    "type": "integer"
                  },
                  "sequence": {
                    "anyOf": [
                      {
                        "maximum": 9223372036854776000,
                        "minimum": 0,
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "title": "Sequence"
                  }
                },
                "required": [
                  "event_time_ms",
                  "received_time_ms"
                ],
                "title": "Observation",
                "type": "object"
              },
              "maxItems": 512,
              "minItems": 1,
              "title": "Observations",
              "type": "array"
            },
            "policy": {
              "additionalProperties": false,
              "properties": {
                "allowed_future_clock_skew_ms": {
                  "maximum": 86400000,
                  "minimum": 0,
                  "title": "Allowed Future Clock Skew Ms",
                  "type": "integer"
                },
                "expected_interval_ms": {
                  "anyOf": [
                    {
                      "maximum": 2678400000,
                      "minimum": 1,
                      "type": "integer"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": null,
                  "title": "Expected Interval Ms"
                },
                "interval_tolerance_ms": {
                  "anyOf": [
                    {
                      "maximum": 2678400000,
                      "minimum": 0,
                      "type": "integer"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": null,
                  "title": "Interval Tolerance Ms"
                },
                "max_age_ms": {
                  "maximum": 2678400000,
                  "minimum": 0,
                  "title": "Max Age Ms",
                  "type": "integer"
                },
                "max_receive_lag_ms": {
                  "maximum": 2678400000,
                  "minimum": 0,
                  "title": "Max Receive Lag Ms",
                  "type": "integer"
                },
                "require_identity_consistency": {
                  "title": "Require Identity Consistency",
                  "type": "boolean"
                },
                "require_sequence": {
                  "title": "Require Sequence",
                  "type": "boolean"
                }
              },
              "required": [
                "max_age_ms",
                "max_receive_lag_ms",
                "require_sequence",
                "require_identity_consistency",
                "allowed_future_clock_skew_ms"
              ],
              "title": "AttestationPolicy",
              "type": "object"
            },
            "source_label": {
              "maxLength": 128,
              "minLength": 1,
              "title": "Source Label",
              "type": "string"
            }
          },
          "required": [
            "dataset_id",
            "source_label",
            "observations",
            "policy"
          ],
          "title": "MarketDataAttestationRequest",
          "type": "object"
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        },
        "method": {
          "enum": [
            "POST",
            "PUT",
            "PATCH"
          ],
          "type": "string"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method",
        "bodyType",
        "body"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "additionalProperties": false,
          "properties": {
            "attestation_id": {
              "description": "Deterministic identity derived from the method version and the observation and policy hashes; independent of wall clock.",
              "pattern": "^mda1_[0-9a-f]{64}$",
              "type": "string"
            },
            "attested_at_ms": {
              "maximum": 9223372036854776000,
              "minimum": 0,
              "type": "integer"
            },
            "checks": {
              "items": {
                "additionalProperties": false,
                "properties": {
                  "check": {
                    "minLength": 1,
                    "type": "string"
                  },
                  "evidence": {
                    "additionalProperties": {
                      "type": [
                        "boolean",
                        "integer",
                        "null",
                        "string"
                      ]
                    },
                    "type": "object"
                  },
                  "status": {
                    "enum": [
                      "PASS",
                      "FAIL"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "check",
                  "status",
                  "evidence"
                ],
                "type": "object"
              },
              "maxItems": 14,
              "minItems": 14,
              "type": "array"
            },
            "dataset_id": {
              "maxLength": 128,
              "minLength": 1,
              "type": "string"
            },
            "disclaimer": {
              "const": "Integrity validation of caller-supplied observations only; no market data is acquired or redistributed, and no ownership, licensing, investment, or trading determination is made.",
              "type": "string"
            },
            "failed_checks": {
              "items": {
                "minLength": 1,
                "type": "string"
              },
              "maxItems": 14,
              "type": "array",
              "uniqueItems": true
            },
            "first_event_time_ms": {
              "maximum": 9223372036854776000,
              "minimum": 0,
              "type": "integer"
            },
            "last_event_time_ms": {
              "maximum": 9223372036854776000,
              "minimum": 0,
              "type": "integer"
            },
            "latest_received_time_ms": {
              "maximum": 9223372036854776000,
              "minimum": 0,
              "type": "integer"
            },
            "method_version": {
              "const": "market-data-integrity-attestation-v1.0.0",
              "type": "string"
            },
            "observation_count": {
              "maximum": 512,
              "minimum": 1,
              "type": "integer"
            },
            "observations_sha256": {
              "pattern": "^[0-9a-f]{64}$",
              "type": "string"
            },
            "policy_sha256": {
              "pattern": "^[0-9a-f]{64}$",
              "type": "string"
            },
            "safe_to_use": {
              "type": "boolean"
            },
            "schema_version": {
              "const": "market-data-attestation-request-v1",
              "type": "string"
            },
            "source_label": {
              "maxLength": 128,
              "minLength": 1,
              "type": "string"
            },
            "verdict": {
              "enum": [
                "PASS",
                "FAIL"
              ],
              "type": "string"
            }
          },
          "required": [
            "schema_version",
            "attestation_id",
            "attested_at_ms",
            "dataset_id",
            "source_label",
            "verdict",
            "safe_to_use",
            "observation_count",
            "first_event_time_ms",
            "last_event_time_ms",
            "latest_received_time_ms",
            "observations_sha256",
            "policy_sha256",
            "checks",
            "failed_checks",
            "method_version",
            "disclaimer"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}