{"openapi":"3.1.0","info":{"title":"Marking API","version":"0.1.0","description":"Discover, purchase, consume, and verify signed information products."},"servers":[{"url":"https://api.marking.fyi"}],"paths":{"/.well-known/marking.json":{"get":{"summary":"Machine-readable Marking discovery","responses":{"200":{"description":"Discovery manifest","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/feeds":{"get":{"summary":"List the currently offered feed catalog","responses":{"200":{"description":"Feed manifests","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/feed-status":{"get":{"summary":"List feed manifests with current real signed updates","responses":{"200":{"description":"Feed status","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/feeds/{feedId}":{"get":{"summary":"Feed manifest and current canonical update","parameters":[{"name":"feedId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Feed","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown feed"}}}},"/v1/feeds/{feedId}/history":{"get":{"summary":"Bounded canonical history","parameters":[{"name":"feedId","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Signed updates","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/feeds/{feedId}/ohlcv":{"get":{"summary":"Seven-day OHLCV candles derived from stored 1s and 1m base candles","parameters":[{"name":"feedId","in":"path","required":true,"schema":{"type":"string"}},{"name":"interval","in":"query","required":false,"schema":{"type":"string"}},{"name":"from","in":"query","required":false,"schema":{"type":"string"}},{"name":"to","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OHLCV candles","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Unsupported interval"},"404":{"description":"Unknown feed"}}}},"/v1/feeds/{feedId}/funding":{"get":{"summary":"Latest funding-rate snapshots for supported perpetual markets","parameters":[{"name":"feedId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Funding rates","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown feed"}}}},"/v1/feeds/{feedId}/book":{"get":{"summary":"Latest top-of-book spread and depth snapshots","parameters":[{"name":"feedId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Top-of-book snapshots","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown feed"}}}},"/v1/feeds/{feedId}/liquidity":{"get":{"summary":"Derived liquidity score from fresh top-of-book snapshots","parameters":[{"name":"feedId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Liquidity score","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown feed or unavailable score"}}}},"/v1/feeds/{feedId}/signals":{"get":{"summary":"Simple market-making and arbitrage signal derived from fresh market microstructure","parameters":[{"name":"feedId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Market signal","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown feed or unavailable signal"}}}},"/v1/feeds/{feedId}/intelligence":{"get":{"summary":"Combined market-intelligence bundle: funding, top-of-book, liquidity and signals","parameters":[{"name":"feedId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Market-intelligence bundle","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown feed"}}}},"/v1/payg/feeds/{feedId}/funding":{"get":{"summary":"Paid x402 funding-rate snapshots","parameters":[{"name":"feedId","in":"path","required":true,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"Omit to receive an x402 challenge."}],"responses":{"200":{"description":"Funding rates","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 payment required"},"404":{"description":"Unknown feed"}}}},"/v1/payg/feeds/{feedId}/book":{"get":{"summary":"Paid x402 top-of-book snapshots","parameters":[{"name":"feedId","in":"path","required":true,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"Omit to receive an x402 challenge."}],"responses":{"200":{"description":"Top-of-book snapshots","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 payment required"},"404":{"description":"Unknown feed"}}}},"/v1/payg/feeds/{feedId}/liquidity":{"get":{"summary":"Paid x402 liquidity score","parameters":[{"name":"feedId","in":"path","required":true,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"Omit to receive an x402 challenge."}],"responses":{"200":{"description":"Liquidity score","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 payment required"},"404":{"description":"Unknown feed or unavailable score"}}}},"/v1/payg/feeds/{feedId}/signals":{"get":{"summary":"Paid x402 market-making and arbitrage signal","parameters":[{"name":"feedId","in":"path","required":true,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"Omit to receive an x402 challenge."}],"responses":{"200":{"description":"Market signal","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 payment required"},"404":{"description":"Unknown feed or unavailable signal"}}}},"/v1/payg/feeds/{feedId}/intelligence":{"get":{"summary":"Paid x402 market-intelligence bundle","parameters":[{"name":"feedId","in":"path","required":true,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"Omit to receive an x402 challenge."}],"responses":{"200":{"description":"Market-intelligence bundle","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 payment required"},"404":{"description":"Unknown feed"}}}},"/v1/sources":{"get":{"summary":"Source inventory and observed health","responses":{"200":{"description":"Sources","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/references":{"get":{"summary":"Latest EIA, FRED and World Bank reference observations","responses":{"200":{"description":"References","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/network":{"get":{"summary":"Aggregate live dashboard state","responses":{"200":{"description":"Network state","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/runtime":{"get":{"summary":"Non-secret runtime certification state","responses":{"200":{"description":"Runtime state","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/leases":{"post":{"summary":"Purchase an agent lease lasting from 60 seconds through 365 days","parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"Omit to receive an x402 challenge."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"201":{"description":"Root-signed, time-bounded agent capability","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 payment required"},"409":{"description":"Payment already consumed"}}}},"/v1/api-keys/introspect":{"post":{"summary":"Validate a durable protocol or human API key","security":[{"apiKey":[]}],"responses":{"200":{"description":"Active key metadata","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Invalid or revoked key"}}}},"/v1/api-keys/stream-credentials":{"post":{"deprecated":true,"summary":"Retired API-key-to-lease exchange","security":[{"apiKey":[]}],"responses":{"410":{"description":"Use the API key directly in the WebSocket Authorization header","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/metrics/latency":{"get":{"summary":"Measured market-data stage latency percentiles","responses":{"200":{"description":"P50, P95 and P99 by stage","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/sports/coverage":{"get":{"summary":"Sports and evidence-policy coverage","responses":{"200":{"description":"Coverage","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/sports/events/{eventId}":{"get":{"summary":"Event and evidence","parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Event","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/sports/events/{eventId}/attestation":{"get":{"summary":"Purchase the current event attestation","parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"Omit to receive an x402 challenge."}],"responses":{"200":{"description":"Signed attestation","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 payment required"}}}},"/v1/attestations":{"get":{"summary":"List issued attestation envelopes","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Attestations","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/attestations/verify":{"post":{"summary":"Verify a Marking attestation for free","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Verification result","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/agents/discover":{"get":{"summary":"Discover agents by capability and reputation","parameters":[{"name":"capability","in":"query","required":false,"schema":{"type":"string"}},{"name":"minimumReputation","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Agents","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/activity":{"get":{"summary":"Read append-only network activity","responses":{"200":{"description":"Activity","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","bearerFormat":"mk_live_...","description":"Durable human and protocol credential. Valid until explicitly revoked."},"x402":{"type":"apiKey","in":"header","name":"PAYMENT-SIGNATURE","description":"x402 v2 exact payment on eip155:84532, solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1, aptos:2, hedera:testnet, eip155:421614, cardano:preprod"}}},"x-marking-stream":{"protocol":"marking.stream.v4","apiKey":{"url":"wss://api.marking.fyi/v1/streams/{feedId}","authorization":"Bearer <api-key>","lifetime":"until-revoked","revocationRecheckSeconds":60},"agentLease":{"url":"wss://api.marking.fyi/v1/streams/{feedId}?leaseId={leaseId}","lifetimeSeconds":{"minimum":60,"maximum":31536000}},"candleUpdates":"wss://api.marking.fyi/v1/streams/{feedId}?candleInterval=1m"}}