{"openapi":"3.1.0","info":{"title":"CoinChing Oracle API","version":"1.2.0","description":"Free deterministic I Ching-inspired lucky coin and Yin-Yang decision oracles. Calls return results directly and require no payment or wallet signature. The service is for entertainment and does not provide professional advice or trading signals."},"servers":[{"url":"https://coinching.a2mcp.cloud"}],"paths":{"/healthz":{"get":{"summary":"Health check","responses":{"200":{"description":"Healthy"}}}},"/v1/capabilities":{"get":{"summary":"Machine-readable capabilities","responses":{"200":{"description":"Capabilities"}}}},"/openapi.json":{"get":{"summary":"This OpenAPI document","responses":{"200":{"description":"OpenAPI"}}}},"/v1/daily":{"post":{"summary":"Daily Lucky Coin Oracle","description":"Deterministic lucky coin cast based on a UTC Unix day bucket and optional private birth date.","x-access-mode":"free","x-price-usdt":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"birthDate":{"type":"string","description":"Accepted formats: dd/mm/yyyy, dd-mm-yyyy, yyyy-mm-dd, yyyy/mm/dd","examples":["21/07/1995"]},"birthTime":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$","example":"14:30"},"timezone":{"type":"string","default":"UTC","example":"Asia/Ho_Chi_Minh"},"universe":{"type":"array","minItems":2,"maxItems":20,"items":{"type":"string","pattern":"^[A-Za-z0-9]{2,12}$"},"example":["BTC","ETH","SOL"]},"locale":{"enum":["en","zh-CN"],"default":"en"},"includeCard":{"type":"boolean","default":true}}},"example":{}}}},"responses":{"200":{"description":"Oracle result, returned directly without payment or wallet authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OracleResponse"}}}},"400":{"description":"Malformed JSON or schema.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Semantically invalid date, time zone, timestamp, question, or universe.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded."},"500":{"description":"Internal error."}}}},"/v1/instant":{"post":{"summary":"Instant Coin Oracle","description":"Deterministic lucky coin cast based on a UTC Unix minute bucket, optional private birth date, and optional private question.","x-access-mode":"free","x-price-usdt":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"birthDate":{"type":"string","description":"Accepted formats: dd/mm/yyyy, dd-mm-yyyy, yyyy-mm-dd, yyyy/mm/dd","examples":["21/07/1995"]},"birthTime":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$","example":"14:30"},"timezone":{"type":"string","default":"UTC","example":"Asia/Ho_Chi_Minh"},"universe":{"type":"array","minItems":2,"maxItems":20,"items":{"type":"string","pattern":"^[A-Za-z0-9]{2,12}$"},"example":["BTC","ETH","SOL"]},"locale":{"enum":["en","zh-CN"],"default":"en"},"includeCard":{"type":"boolean","default":true},"question":{"type":"string","minLength":1,"maxLength":280},"at":{"type":"string","format":"date-time"}}},"example":{}}}},"responses":{"200":{"description":"Oracle result, returned directly without payment or wallet authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OracleResponse"}}}},"400":{"description":"Malformed JSON or schema.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Semantically invalid date, time zone, timestamp, question, or universe.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded."},"500":{"description":"Internal error."}}}},"/v1/decision":{"post":{"summary":"Yin-Yang Decision Oracle","description":"Deterministic Yin-Yang Yes/No cast based on a Unix second and an optional private question.","x-access-mode":"free","x-price-usdt":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"question":{"type":"string","minLength":1,"maxLength":280},"locale":{"enum":["en","zh-CN"],"default":"en"},"at":{"type":"string","format":"date-time"}}},"example":{}}}},"responses":{"200":{"description":"Oracle result, returned directly without payment or wallet authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecisionResponse"}}}},"400":{"description":"Malformed JSON or schema.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Semantically invalid date, time zone, timestamp, question, or universe.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded."},"500":{"description":"Internal error."}}}}},"components":{"schemas":{"ErrorResponse":{"type":"object","required":["error","message","requestId"],"additionalProperties":false,"properties":{"error":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}}},"OracleResponse":{"type":"object","required":["requestId","schemaVersion","mode","generatedAt","basis","result","commentary","proof","share","disclaimer"],"properties":{"requestId":{"type":"string"},"schemaVersion":{"const":"1.0"},"mode":{"enum":["daily","instant"]},"generatedAt":{"type":"string","format":"date-time"},"basis":{"type":"object","required":["type","epochSeconds","birthDateUsed"],"properties":{"type":{"enum":["unix_day","unix_minute"]},"epochSeconds":{"type":"string","pattern":"^\\d+$"},"birthDateUsed":{"type":"boolean"}}},"result":{"type":"object"},"commentary":{"type":"object"},"proof":{"type":"object"},"share":{"type":"object"},"disclaimer":{"type":"object"}}},"DecisionResponse":{"type":"object","required":["requestId","schemaVersion","mode","generatedAt","basis","result","commentary","proof","disclaimer"],"additionalProperties":false,"properties":{"requestId":{"type":"string"},"schemaVersion":{"const":"1.0"},"mode":{"const":"decision"},"generatedAt":{"type":"string","format":"date-time"},"basis":{"type":"object","required":["type","epochSeconds","questionUsed"],"additionalProperties":false,"properties":{"type":{"const":"unix_second"},"epochSeconds":{"type":"string","pattern":"^\\d+$"},"questionUsed":{"type":"boolean"}}},"result":{"type":"object","required":["polarity","symbol","answer","boolean"],"additionalProperties":false,"properties":{"polarity":{"enum":["yin","yang"]},"symbol":{"enum":["⚊","⚋"]},"answer":{"enum":["yes","no"]},"boolean":{"type":"boolean"}}},"commentary":{"type":"object"},"proof":{"type":"object"},"disclaimer":{"type":"object"}}}}}}