{"components":{"schemas":{"Error":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"type":"object"}},"type":"object"},"EvaluateResult":{"properties":{"company_name":{"type":["string","null"]},"conclusion":{"properties":{"fair_value_range_usd":{"items":{"type":"number"},"type":["array","null"]},"price_tier":{"description":"便宜 | 合理 | 透支 | 数据不足","type":"string"},"quality_reason":{"type":["string","null"]},"quality_tier":{"description":"大道级 | 优质 | 平庸 | 陷阱","type":["string","null"]},"valuation_note":{"type":"string"}},"type":"object"},"disclaimer":{"type":"string"},"full_report":{"properties":{"note":{"type":"string"},"price_usd":{"type":"number"},"url":{"type":"string"}},"type":"object"},"key_figures":{"items":{"properties":{"label":{"type":"string"},"period":{"type":["string","null"]},"source":{"type":"string"},"value":{"type":["number","null"]}},"type":"object"},"type":"array"},"locked":{"type":"boolean"},"questions":{"description":"Three must-answer questions.","items":{"type":"string"},"type":"array"},"steps":{"description":"Five steps; steps 3-5 have empty content in the free tier.","items":{"properties":{"content":{"type":"string"},"title":{"type":"string"}},"type":"object"},"type":"array"},"ticker":{"type":"string"}},"type":"object"}}},"info":{"description":"Value-investing education agent API. evaluate_company runs a five-step business-owner checkup on a US-listed company and returns a dual-axis conclusion (quality tier x price tier), a deterministic EPSxPE fair-value range, the first two analysis steps and three must-answer questions. Free tier, cached per company for 24h. Education/framework only — not investment advice. MCP equivalent: POST https://dadaovalue.com/api/mcp (tools evaluate_company, ask_framework).","title":"Dadao Value Agent API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/api/v1/ask":{"post":{"operationId":"askFramework","requestBody":{"content":{"application/json":{"schema":{"properties":{"question":{"maxLength":500,"type":"string"}},"required":["question"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"answer":{"type":"string"},"disclaimer":{"type":"string"},"refused":{"type":"boolean"}},"type":"object"}}},"description":"Framework answer from the Dadao Value knowledge base"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid input"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Daily agent-API budget exhausted"}},"summary":"Ask a value-investing framework question"}},"/api/v1/evaluate":{"get":{"operationId":"evaluateCompanyGet","parameters":[{"description":"US ticker symbol (AAPL) or company name (Apple).","in":"query","name":"ticker","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvaluateResult"}}},"description":"Checkup result (free tier, steps 3-5 locked)"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not a US-listed company"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Daily agent-API budget exhausted"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"AI service temporarily unavailable"}},"summary":"Evaluate a US-listed company (GET)"},"post":{"operationId":"evaluateCompany","requestBody":{"content":{"application/json":{"schema":{"properties":{"ticker":{"type":"string"}},"required":["ticker"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvaluateResult"}}},"description":"Checkup result (free tier, steps 3-5 locked)"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid input"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not a US-listed company"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Daily agent-API budget exhausted"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"AI service temporarily unavailable"}},"summary":"Evaluate a US-listed company (POST)"}}},"servers":[{"url":"https://dadaovalue.com"}]}