{"openapi":"3.1.0","info":{"title":"UnlockPressure x402 Paid API","version":"1.0.0","description":"Source-backed token unlock sell-pressure intelligence, paid per call with x402 on Base USDC."},"externalDocs":{"description":"x402 buyer example","url":"https://unlockpressure.pricepilot402-arya.workers.dev/examples/x402-buyer"},"paths":{"/v1/unlocks/upcoming":{"get":{"summary":"x402-paid filtered upcoming unlocks","description":"Returns upcoming unlock events with modeled sell-pressure risk after x402 settlement.","parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-PAYMENT","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":365}},{"name":"minRisk","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":100}}],"responses":{"200":{"description":"Paid unlock risk list","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"days":{"type":"integer"},"minRisk":{"type":"integer"},"unlocks":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"token":{"type":"string"},"unlock_event_id":{"type":"string"},"risk_score":{"type":"number"},"risk_level":{"type":"string"},"evidence":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["token","unlock_event_id","risk_score","risk_level"]}}},"required":["days","minRisk","unlocks"]}}}},"402":{"description":"x402 payment required. Read PAYMENT-REQUIRED, create a Base USDC proof, and retry with PAYMENT-SIGNATURE or X-PAYMENT."}},"x-payment-info":{"protocol":"x402","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","price":{"amount":"0.02","currency":"USD"}},"x402-bazaar":{"category":"token-unlock-risk","tags":["token-unlocks","sell-pressure","risk-intelligence","x402","base-usdc"],"input":{"type":"http","method":"GET","queryParams":{"days":30,"minRisk":70}},"inputSchema":{"type":"object","additionalProperties":false,"properties":{"days":{"type":"integer","minimum":1,"maximum":365,"default":30,"description":"Forward-looking unlock window in days."},"minRisk":{"type":"integer","minimum":0,"maximum":100,"default":0,"description":"Minimum modeled risk score to include."}}},"output":{"type":"json","example":{"days":30,"minRisk":70,"unlocks":[{"token":"ARB","unlock_event_id":"unlock_arb_2026_08","risk_score":82,"risk_level":"high","evidence":[]}]},"schema":{"type":"object","additionalProperties":true,"properties":{"days":{"type":"integer"},"minRisk":{"type":"integer"},"unlocks":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"token":{"type":"string"},"unlock_event_id":{"type":"string"},"risk_score":{"type":"number"},"risk_level":{"type":"string"},"evidence":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["token","unlock_event_id","risk_score","risk_level"]}}},"required":["days","minRisk","unlocks"]}},"extensions":{"bazaar":{"discoverable":true,"category":"token-unlock-risk","tags":["token-unlocks","sell-pressure","risk-intelligence","x402","base-usdc"],"info":{"input":{"type":"http","method":"GET","queryParams":{"days":30,"minRisk":70}},"output":{"type":"json","example":{"days":30,"minRisk":70,"unlocks":[{"token":"ARB","unlock_event_id":"unlock_arb_2026_08","risk_score":82,"risk_level":"high","evidence":[]}]}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","additionalProperties":false,"properties":{"input":{"type":"object","additionalProperties":false,"properties":{"type":{"const":"http","type":"string"},"method":{"const":"GET","type":"string"},"queryParams":{"type":"object","additionalProperties":false,"properties":{"days":{"type":"integer","minimum":1,"maximum":365,"default":30,"description":"Forward-looking unlock window in days."},"minRisk":{"type":"integer","minimum":0,"maximum":100,"default":0,"description":"Minimum modeled risk score to include."}}}},"required":["type","method","queryParams"]},"output":{"type":"object","additionalProperties":false,"properties":{"type":{"const":"json","type":"string"},"example":{"type":"object","additionalProperties":true,"properties":{"days":{"type":"integer"},"minRisk":{"type":"integer"},"unlocks":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"token":{"type":"string"},"unlock_event_id":{"type":"string"},"risk_score":{"type":"number"},"risk_level":{"type":"string"},"evidence":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["token","unlock_event_id","risk_score","risk_level"]}}},"required":["days","minRisk","unlocks"]}},"required":["type","example"]}},"required":["input"],"input":{"type":"object","additionalProperties":false,"properties":{"days":{"type":"integer","minimum":1,"maximum":365,"default":30,"description":"Forward-looking unlock window in days."},"minRisk":{"type":"integer","minimum":0,"maximum":100,"default":0,"description":"Minimum modeled risk score to include."}}},"output":{"type":"object","additionalProperties":true,"properties":{"days":{"type":"integer"},"minRisk":{"type":"integer"},"unlocks":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"token":{"type":"string"},"unlock_event_id":{"type":"string"},"risk_score":{"type":"number"},"risk_level":{"type":"string"},"evidence":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["token","unlock_event_id","risk_score","risk_level"]}}},"required":["days","minRisk","unlocks"]}}}}}}},"/v1/unlock-risk":{"post":{"summary":"x402-paid event-level unlock risk score","description":"Scores one token unlock event using source confidence, liquidity context, and unlock size.","parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-PAYMENT","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"token":{"type":"string","minLength":1,"description":"Token symbol for the unlock event."},"unlock_event_id":{"type":"string","minLength":1,"description":"Unlock event identifier returned by the scanner."},"includeEvidence":{"type":"boolean","default":true,"description":"Include evidence records in the paid response."}},"required":["token","unlock_event_id"]}}}},"responses":{"200":{"description":"Paid event-level risk score","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"token":{"type":"string"},"unlock_event_id":{"type":"string"},"risk_score":{"type":"number"},"risk_level":{"type":"string"},"evidence":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["token","unlock_event_id","risk_score","risk_level"]}}}},"402":{"description":"x402 payment required. Read PAYMENT-REQUIRED, create a Base USDC proof, and retry with PAYMENT-SIGNATURE or X-PAYMENT."}},"x-payment-info":{"protocol":"x402","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","price":{"amount":"0.10","currency":"USD"}},"x402-bazaar":{"category":"token-unlock-risk","tags":["token-unlocks","sell-pressure","risk-intelligence","x402","base-usdc"],"input":{"type":"http","method":"POST","bodyType":"json","body":{"token":"ARB","unlock_event_id":"unlock_arb_2026_08","includeEvidence":true}},"inputSchema":{"type":"object","additionalProperties":false,"properties":{"token":{"type":"string","minLength":1,"description":"Token symbol for the unlock event."},"unlock_event_id":{"type":"string","minLength":1,"description":"Unlock event identifier returned by the scanner."},"includeEvidence":{"type":"boolean","default":true,"description":"Include evidence records in the paid response."}},"required":["token","unlock_event_id"]},"bodyType":"json","output":{"type":"json","example":{"token":"ARB","unlock_event_id":"unlock_arb_2026_08","risk_score":82,"risk_level":"high","evidence":[]},"schema":{"type":"object","additionalProperties":true,"properties":{"token":{"type":"string"},"unlock_event_id":{"type":"string"},"risk_score":{"type":"number"},"risk_level":{"type":"string"},"evidence":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["token","unlock_event_id","risk_score","risk_level"]}},"extensions":{"bazaar":{"discoverable":true,"category":"token-unlock-risk","tags":["token-unlocks","sell-pressure","risk-intelligence","x402","base-usdc"],"info":{"input":{"type":"http","method":"POST","bodyType":"json","body":{"token":"ARB","unlock_event_id":"unlock_arb_2026_08","includeEvidence":true}},"output":{"type":"json","example":{"token":"ARB","unlock_event_id":"unlock_arb_2026_08","risk_score":82,"risk_level":"high","evidence":[]}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","additionalProperties":false,"properties":{"input":{"type":"object","additionalProperties":false,"properties":{"type":{"const":"http","type":"string"},"method":{"const":"POST","type":"string"},"bodyType":{"const":"json","type":"string"},"body":{"type":"object","additionalProperties":false,"properties":{"token":{"type":"string","minLength":1,"description":"Token symbol for the unlock event."},"unlock_event_id":{"type":"string","minLength":1,"description":"Unlock event identifier returned by the scanner."},"includeEvidence":{"type":"boolean","default":true,"description":"Include evidence records in the paid response."}},"required":["token","unlock_event_id"]}},"required":["type","method","bodyType","body"]},"output":{"type":"object","additionalProperties":false,"properties":{"type":{"const":"json","type":"string"},"example":{"type":"object","additionalProperties":true,"properties":{"token":{"type":"string"},"unlock_event_id":{"type":"string"},"risk_score":{"type":"number"},"risk_level":{"type":"string"},"evidence":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["token","unlock_event_id","risk_score","risk_level"]}},"required":["type","example"]}},"required":["input"],"input":{"type":"object","additionalProperties":false,"properties":{"token":{"type":"string","minLength":1,"description":"Token symbol for the unlock event."},"unlock_event_id":{"type":"string","minLength":1,"description":"Unlock event identifier returned by the scanner."},"includeEvidence":{"type":"boolean","default":true,"description":"Include evidence records in the paid response."}},"required":["token","unlock_event_id"]},"output":{"type":"object","additionalProperties":true,"properties":{"token":{"type":"string"},"unlock_event_id":{"type":"string"},"risk_score":{"type":"number"},"risk_level":{"type":"string"},"evidence":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["token","unlock_event_id","risk_score","risk_level"]}}}}}}},"/v1/token/risk-summary":{"post":{"summary":"x402-paid 90-day token unlock risk summary","description":"Summarizes token-level unlock risk across a configurable window after x402 settlement.","parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-PAYMENT","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"token":{"type":"string","minLength":1,"description":"Token symbol to summarize."},"lookbackDays":{"type":"integer","minimum":1,"maximum":365,"default":90,"description":"Risk aggregation window."}},"required":["token"]}}}},"responses":{"200":{"description":"Paid token-level risk summary","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"token":{"type":"string"},"windowDays":{"type":"integer"},"eventCount":{"type":"integer"},"maxRiskScore":{"type":"number"},"riskLevel":{"type":"string"}},"required":["token","windowDays","eventCount"]}}}},"402":{"description":"x402 payment required. Read PAYMENT-REQUIRED, create a Base USDC proof, and retry with PAYMENT-SIGNATURE or X-PAYMENT."}},"x-payment-info":{"protocol":"x402","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","price":{"amount":"0.25","currency":"USD"}},"x402-bazaar":{"category":"token-unlock-risk","tags":["token-unlocks","sell-pressure","risk-intelligence","x402","base-usdc"],"input":{"type":"http","method":"POST","bodyType":"json","body":{"token":"ARB","lookbackDays":90}},"inputSchema":{"type":"object","additionalProperties":false,"properties":{"token":{"type":"string","minLength":1,"description":"Token symbol to summarize."},"lookbackDays":{"type":"integer","minimum":1,"maximum":365,"default":90,"description":"Risk aggregation window."}},"required":["token"]},"bodyType":"json","output":{"type":"json","example":{"token":"ARB","windowDays":90,"eventCount":3,"maxRiskScore":82,"riskLevel":"high"},"schema":{"type":"object","additionalProperties":true,"properties":{"token":{"type":"string"},"windowDays":{"type":"integer"},"eventCount":{"type":"integer"},"maxRiskScore":{"type":"number"},"riskLevel":{"type":"string"}},"required":["token","windowDays","eventCount"]}},"extensions":{"bazaar":{"discoverable":true,"category":"token-unlock-risk","tags":["token-unlocks","sell-pressure","risk-intelligence","x402","base-usdc"],"info":{"input":{"type":"http","method":"POST","bodyType":"json","body":{"token":"ARB","lookbackDays":90}},"output":{"type":"json","example":{"token":"ARB","windowDays":90,"eventCount":3,"maxRiskScore":82,"riskLevel":"high"}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","additionalProperties":false,"properties":{"input":{"type":"object","additionalProperties":false,"properties":{"type":{"const":"http","type":"string"},"method":{"const":"POST","type":"string"},"bodyType":{"const":"json","type":"string"},"body":{"type":"object","additionalProperties":false,"properties":{"token":{"type":"string","minLength":1,"description":"Token symbol to summarize."},"lookbackDays":{"type":"integer","minimum":1,"maximum":365,"default":90,"description":"Risk aggregation window."}},"required":["token"]}},"required":["type","method","bodyType","body"]},"output":{"type":"object","additionalProperties":false,"properties":{"type":{"const":"json","type":"string"},"example":{"type":"object","additionalProperties":true,"properties":{"token":{"type":"string"},"windowDays":{"type":"integer"},"eventCount":{"type":"integer"},"maxRiskScore":{"type":"number"},"riskLevel":{"type":"string"}},"required":["token","windowDays","eventCount"]}},"required":["type","example"]}},"required":["input"],"input":{"type":"object","additionalProperties":false,"properties":{"token":{"type":"string","minLength":1,"description":"Token symbol to summarize."},"lookbackDays":{"type":"integer","minimum":1,"maximum":365,"default":90,"description":"Risk aggregation window."}},"required":["token"]},"output":{"type":"object","additionalProperties":true,"properties":{"token":{"type":"string"},"windowDays":{"type":"integer"},"eventCount":{"type":"integer"},"maxRiskScore":{"type":"number"},"riskLevel":{"type":"string"}},"required":["token","windowDays","eventCount"]}}}}}}},"/v1/unlock/backtest":{"post":{"summary":"x402-paid historical unlock event study","description":"Returns historical post-unlock market response windows for one unlock event after x402 settlement.","parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-PAYMENT","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"token":{"type":"string","minLength":1,"description":"Token symbol for the historical unlock event."},"unlock_event_id":{"type":"string","minLength":1,"description":"Unlock event identifier returned by the scanner."},"windowDays":{"type":"integer","minimum":1,"maximum":120,"default":14,"description":"Post-unlock study window."}},"required":["token","unlock_event_id"]}}}},"responses":{"200":{"description":"Paid unlock backtest windows","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"token":{"type":"string"},"unlock_event_id":{"type":"string"},"windowDays":{"type":"integer"},"reactions":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"402":{"description":"x402 payment required. Read PAYMENT-REQUIRED, create a Base USDC proof, and retry with PAYMENT-SIGNATURE or X-PAYMENT."}},"x-payment-info":{"protocol":"x402","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","price":{"amount":"0.50","currency":"USD"}},"x402-bazaar":{"category":"token-unlock-risk","tags":["token-unlocks","sell-pressure","risk-intelligence","x402","base-usdc"],"input":{"type":"http","method":"POST","bodyType":"json","body":{"token":"ARB","unlock_event_id":"unlock_arb_2026_08","windowDays":14}},"inputSchema":{"type":"object","additionalProperties":false,"properties":{"token":{"type":"string","minLength":1,"description":"Token symbol for the historical unlock event."},"unlock_event_id":{"type":"string","minLength":1,"description":"Unlock event identifier returned by the scanner."},"windowDays":{"type":"integer","minimum":1,"maximum":120,"default":14,"description":"Post-unlock study window."}},"required":["token","unlock_event_id"]},"bodyType":"json","output":{"type":"json","example":{"token":"ARB","unlock_event_id":"unlock_arb_2026_08","windowDays":14,"reactions":[{"return_pct":-7.4,"volume_change_pct":18.5,"confidence":"medium"}]},"schema":{"type":"object","additionalProperties":true,"properties":{"token":{"type":"string"},"unlock_event_id":{"type":"string"},"windowDays":{"type":"integer"},"reactions":{"type":"array","items":{"type":"object","additionalProperties":true}}}}},"extensions":{"bazaar":{"discoverable":true,"category":"token-unlock-risk","tags":["token-unlocks","sell-pressure","risk-intelligence","x402","base-usdc"],"info":{"input":{"type":"http","method":"POST","bodyType":"json","body":{"token":"ARB","unlock_event_id":"unlock_arb_2026_08","windowDays":14}},"output":{"type":"json","example":{"token":"ARB","unlock_event_id":"unlock_arb_2026_08","windowDays":14,"reactions":[{"return_pct":-7.4,"volume_change_pct":18.5,"confidence":"medium"}]}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","additionalProperties":false,"properties":{"input":{"type":"object","additionalProperties":false,"properties":{"type":{"const":"http","type":"string"},"method":{"const":"POST","type":"string"},"bodyType":{"const":"json","type":"string"},"body":{"type":"object","additionalProperties":false,"properties":{"token":{"type":"string","minLength":1,"description":"Token symbol for the historical unlock event."},"unlock_event_id":{"type":"string","minLength":1,"description":"Unlock event identifier returned by the scanner."},"windowDays":{"type":"integer","minimum":1,"maximum":120,"default":14,"description":"Post-unlock study window."}},"required":["token","unlock_event_id"]}},"required":["type","method","bodyType","body"]},"output":{"type":"object","additionalProperties":false,"properties":{"type":{"const":"json","type":"string"},"example":{"type":"object","additionalProperties":true,"properties":{"token":{"type":"string"},"unlock_event_id":{"type":"string"},"windowDays":{"type":"integer"},"reactions":{"type":"array","items":{"type":"object","additionalProperties":true}}}}},"required":["type","example"]}},"required":["input"],"input":{"type":"object","additionalProperties":false,"properties":{"token":{"type":"string","minLength":1,"description":"Token symbol for the historical unlock event."},"unlock_event_id":{"type":"string","minLength":1,"description":"Unlock event identifier returned by the scanner."},"windowDays":{"type":"integer","minimum":1,"maximum":120,"default":14,"description":"Post-unlock study window."}},"required":["token","unlock_event_id"]},"output":{"type":"object","additionalProperties":true,"properties":{"token":{"type":"string"},"unlock_event_id":{"type":"string"},"windowDays":{"type":"integer"},"reactions":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}}}}}}}