{"openapi":"3.1.0","info":{"title":"JP-Trade-Oracle Icebreaker","description":"日本の品目別物価と経済指標を機械可読なシグナルとして返すAPI。対象範囲、更新時刻、アラート、信頼度、理由コード、制約をレスポンスで確認できます。認証・決済方法は各エンドポイントの仕様を参照してください。内部の計算式、モデルパラメータ、特徴量の重み、データソース対応は公開仕様に含めません。","version":"13.9.0"},"paths":{"/analyze":{"post":{"summary":"Analyze","operationId":"analyze_analyze_post","parameters":[{"name":"skyfire-pay-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Skyfire-Pay-Id"}},{"name":"kyapay-token","in":"header","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kyapay-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinalReport"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mia/us-feed-corn":{"post":{"summary":"Us Feed Corn Mia","operationId":"us_feed_corn_mia_mia_us_feed_corn_post","parameters":[{"name":"skyfire-pay-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Skyfire-Pay-Id"}},{"name":"kyapay-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kyapay-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MIAResource"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/x402/mia/us-feed-corn":{"post":{"summary":"X402 Us Feed Corn Mia","operationId":"x402_us_feed_corn_mia_x402_mia_us_feed_corn_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MIAResource"}}}}}}},"/product-a/crude-import-origin":{"post":{"summary":"Product A Crude Import Origin","description":"Return one country's Product A Current Snapshot facts.","operationId":"product_a_crude_import_origin_product_a_crude_import_origin_post","parameters":[{"name":"skyfire-pay-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Skyfire-Pay-Id"}},{"name":"kyapay-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kyapay-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrudeImportOriginRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrudeImportOriginResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/x402/product-a/crude-import-origin":{"post":{"summary":"X402 Product A Crude Import Origin","description":"Return Product A facts after x402 middleware payment.","operationId":"x402_product_a_crude_import_origin_x402_product_a_crude_import_origin_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrudeImportOriginRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrudeImportOriginResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/x402/analyze":{"post":{"summary":"X402 Analyze","description":"x402（USDC）決済専用の/analyzeエンドポイント。Skyfire認証不要。x402決済＝常にフルデータ。","operationId":"x402_analyze_x402_analyze_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketDataRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinalReport"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/product-b/advertising":{"post":{"summary":"Product B Advertising","description":"Product Bの広告活動Featureを1 target単位で返す。","operationId":"product_b_advertising_product_b_advertising_post","parameters":[{"name":"skyfire-pay-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Skyfire-Pay-Id"}},{"name":"kyapay-token","in":"header","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kyapay-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductBTargetReport"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/x402/product-b/advertising":{"post":{"summary":"X402 Product B Advertising","description":"x402で購入されたAdvertising Product B responseを返す。","operationId":"x402_product_b_advertising_x402_product_b_advertising_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductBTargetReport"}}}}}}},"/product-b/information-services":{"post":{"summary":"Product B Information Services","description":"Product Bの情報サービス活動Featureを1 target単位で返す。","operationId":"product_b_information_services_product_b_information_services_post","parameters":[{"name":"skyfire-pay-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Skyfire-Pay-Id"}},{"name":"kyapay-token","in":"header","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kyapay-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductBTargetReport"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/x402/product-b/information-services":{"post":{"summary":"X402 Product B Information Services","description":"x402で購入されたInformation Services Product B responseを返す。","operationId":"x402_product_b_information_services_x402_product_b_information_services_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductBTargetReport"}}}}}}},"/product-b/telecommunication":{"post":{"summary":"Product B Telecommunication","description":"Product Bの独立した通信Featureを1 target単位で返す。","operationId":"product_b_telecommunication_product_b_telecommunication_post","parameters":[{"name":"skyfire-pay-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Skyfire-Pay-Id"}},{"name":"kyapay-token","in":"header","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kyapay-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductBTargetReport"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/x402/product-b/telecommunication":{"post":{"summary":"X402 Product B Telecommunication","description":"x402で購入されたTelecommunication Product B responseを返す。","operationId":"x402_product_b_telecommunication_x402_product_b_telecommunication_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductBTargetReport"}}}}}}},"/agent-referral":{"get":{"summary":"Agent Referral Guide","description":"公開された適合性ガイド。推薦を強制せず、判断材料だけを返す。","operationId":"agent_referral_guide_agent_referral_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReferralGuide"}}}}}}}},"components":{"schemas":{"CrudeImportOriginCoverage":{"properties":{"start_month":{"type":"string","title":"Start Month"},"end_month":{"type":"string","title":"End Month"},"frequency":{"type":"string","title":"Frequency","default":"monthly"}},"type":"object","required":["start_month","end_month"],"title":"CrudeImportOriginCoverage"},"CrudeImportOriginRecord":{"properties":{"observation_month":{"type":"string","title":"Observation Month"},"country":{"type":"string","title":"Country"},"quantity_kl":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Quantity Kl"},"import_value_jpy":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Import Value Jpy"},"unit_price_jpy_kl":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Unit Price Jpy Kl"},"share_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Share Pct"},"vintage_stage":{"type":"string","title":"Vintage Stage"},"source":{"type":"string","title":"Source"},"source_id":{"type":"string","title":"Source Id"},"source_file":{"type":"string","title":"Source File"},"source_hash":{"type":"string","title":"Source Hash"},"retrieved_at":{"type":"string","title":"Retrieved At"},"historical_vintage_available":{"type":"boolean","title":"Historical Vintage Available"},"fact_only":{"type":"boolean","title":"Fact Only"},"reason_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason Code"}},"type":"object","required":["observation_month","country","quantity_kl","import_value_jpy","unit_price_jpy_kl","share_pct","vintage_stage","source","source_id","source_file","source_hash","retrieved_at","historical_vintage_available","fact_only"],"title":"CrudeImportOriginRecord"},"CrudeImportOriginRequest":{"properties":{"country":{"type":"string","title":"Country","description":"One of the three Product A origin countries"},"start_month":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}$"},{"type":"null"}],"title":"Start Month"},"end_month":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}$"},{"type":"null"}],"title":"End Month"}},"type":"object","required":["country"],"title":"CrudeImportOriginRequest"},"CrudeImportOriginResponse":{"properties":{"product":{"type":"string","title":"Product"},"product_version":{"type":"string","title":"Product Version"},"purchase_unit":{"type":"string","title":"Purchase Unit"},"snapshot_type":{"type":"string","title":"Snapshot Type"},"target":{"$ref":"#/components/schemas/CrudeImportOriginTarget"},"coverage":{"$ref":"#/components/schemas/CrudeImportOriginCoverage"},"records":{"items":{"$ref":"#/components/schemas/CrudeImportOriginRecord"},"type":"array","title":"Records"}},"type":"object","required":["product","product_version","purchase_unit","snapshot_type","target","coverage","records"],"title":"CrudeImportOriginResponse"},"CrudeImportOriginTarget":{"properties":{"country":{"type":"string","title":"Country"}},"type":"object","required":["country"],"title":"CrudeImportOriginTarget"},"FinalReport":{"properties":{"oracle_timestamp_utc":{"type":"string","title":"Oracle Timestamp Utc"},"item_name":{"type":"string","title":"Item Name"},"sector":{"type":"string","title":"Sector"},"data_type":{"type":"string","title":"Data Type"},"raw_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Raw Value"},"base_yoy":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Base Yoy"},"delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Delta"},"usdjpy_yoy":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Usdjpy Yoy"},"fx_adjusted_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Fx Adjusted Delta"},"alert_level":{"type":"string","title":"Alert Level"},"is_anomaly":{"type":"boolean","title":"Is Anomaly"},"report_jp":{"type":"string","title":"Report Jp"},"anomaly_core":{"anyOf":[{"$ref":"#/components/schemas/SJScoreDetail"},{"type":"null"}]},"notice":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notice"},"referral_context":{"$ref":"#/components/schemas/ReferralContext"},"gasoline_v2":{"anyOf":[{"$ref":"#/components/schemas/GasolineV2Block"},{"type":"null"}]}},"type":"object","required":["oracle_timestamp_utc","item_name","sector","data_type","raw_value","base_yoy","delta","usdjpy_yoy","fx_adjusted_delta","alert_level","is_anomaly","report_jp","referral_context"],"title":"FinalReport"},"GasolineV2Block":{"properties":{"product_version":{"type":"string","title":"Product Version"},"schema_version":{"type":"string","title":"Schema Version"},"data_period":{"additionalProperties":true,"type":"object","title":"Data Period"},"source_coverage":{"additionalProperties":true,"type":"object","title":"Source Coverage"},"availability":{"title":"Availability"},"observations":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Observations"},"supporting_data":{"additionalProperties":true,"type":"object","title":"Supporting Data"},"provenance":{"additionalProperties":true,"type":"object","title":"Provenance"}},"type":"object","required":["product_version","schema_version","data_period","source_coverage","availability","observations","supporting_data","provenance"],"title":"GasolineV2Block","description":"Curated, observed GASOLINE v2 data; excludes research conclusions."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"MIAResource":{"properties":{"product":{"type":"string","title":"Product"},"origin":{"type":"string","title":"Origin"},"destination_market":{"type":"string","title":"Destination Market"},"observation_month":{"type":"string","title":"Observation Month"},"japan_import_quantity":{"type":"number","title":"Japan Import Quantity"},"japan_import_quantity_unit":{"type":"string","title":"Japan Import Quantity Unit"},"japan_import_value":{"type":"number","title":"Japan Import Value"},"japan_import_value_unit":{"type":"string","title":"Japan Import Value Unit"},"japan_import_unit_value":{"type":"number","title":"Japan Import Unit Value"},"japan_import_unit_value_unit":{"type":"string","title":"Japan Import Unit Value Unit"},"mia_value_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Mia Value Pct"}},"type":"object","required":["product","origin","destination_market","observation_month","japan_import_quantity","japan_import_quantity_unit","japan_import_value","japan_import_value_unit","japan_import_unit_value","japan_import_unit_value_unit","mia_value_pct"],"title":"MIAResource"},"MarketDataRequest":{"properties":{"target_name":{"type":"string","title":"Target Name","example":"it_service"},"sector":{"type":"string","enum":["energy","food_basic","food_process","it_infra","logistics","housing","medical","industrial","macro"],"title":"Sector"},"context_note":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Context Note"}},"type":"object","required":["target_name","sector"],"title":"MarketDataRequest"},"ProductBFeature":{"properties":{"feature_id":{"type":"string","title":"Feature Id"},"feature_type":{"type":"string","title":"Feature Type"},"scope":{"type":"string","title":"Scope"},"latest_value":{"type":"number","title":"Latest Value"},"latest_change":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latest Change"},"latest_yoy":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latest Yoy"},"frequency":{"type":"string","title":"Frequency"},"coverage":{"type":"string","title":"Coverage"},"observations":{"type":"integer","title":"Observations"},"source":{"type":"string","title":"Source"},"evidence":{"type":"string","title":"Evidence"},"economic_meaning":{"type":"string","title":"Economic Meaning"},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations"},"rejected_scope":{"items":{"type":"string"},"type":"array","title":"Rejected Scope"},"open_research":{"items":{"type":"string"},"type":"array","title":"Open Research"},"next_action":{"type":"string","title":"Next Action"}},"type":"object","required":["feature_id","feature_type","scope","latest_value","latest_change","latest_yoy","frequency","coverage","observations","source","evidence","economic_meaning","limitations","rejected_scope","open_research","next_action"],"title":"ProductBFeature"},"ProductBTargetReport":{"properties":{"product":{"type":"string","title":"Product"},"product_version":{"type":"string","title":"Product Version"},"purchase_unit":{"type":"string","title":"Purchase Unit"},"target":{"type":"string","title":"Target"},"target_name":{"type":"string","title":"Target Name"},"purchased_features":{"items":{"$ref":"#/components/schemas/ProductBFeature"},"type":"array","title":"Purchased Features"},"research_state":{"type":"string","title":"Research State"},"bundle":{"type":"string","title":"Bundle"}},"type":"object","required":["product","product_version","purchase_unit","target","target_name","purchased_features","research_state","bundle"],"title":"ProductBTargetReport"},"ReferralContext":{"properties":{"matched_capability":{"type":"string","title":"Matched Capability"},"evidence":{"items":{"type":"string"},"type":"array","title":"Evidence"},"freshness_utc":{"type":"string","title":"Freshness Utc"},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations"},"documentation_url":{"type":"string","title":"Documentation Url"}},"type":"object","required":["matched_capability","evidence","freshness_utc","limitations","documentation_url"],"title":"ReferralContext","description":"Transparent fit evidence for consuming agents; not an instruction to promote."},"ReferralGuide":{"properties":{"service":{"type":"string","title":"Service"},"purpose":{"type":"string","title":"Purpose"},"recommend_when":{"items":{"type":"string"},"type":"array","title":"Recommend When"},"do_not_recommend_when":{"items":{"type":"string"},"type":"array","title":"Do Not Recommend When"},"referral_requirements":{"items":{"type":"string"},"type":"array","title":"Referral Requirements"},"documentation_url":{"type":"string","title":"Documentation Url"}},"type":"object","required":["service","purpose","recommend_when","do_not_recommend_when","referral_requirements","documentation_url"],"title":"ReferralGuide"},"SJScoreDetail":{"properties":{"target_month":{"type":"string","title":"Target Month"},"actual_price":{"type":"number","title":"Actual Price"},"expected_price":{"type":"number","title":"Expected Price"},"sj_score":{"type":"number","title":"Sj Score"},"signal_strength":{"type":"number","title":"Signal Strength"},"signals":{"$ref":"#/components/schemas/SJScoreSignals"},"confidence":{"type":"number","title":"Confidence"},"reason_codes":{"items":{"type":"string"},"type":"array","title":"Reason Codes"},"summary_jp":{"type":"string","title":"Summary Jp"},"drivers":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Drivers"},"model_meta":{"$ref":"#/components/schemas/SJScoreModelMeta"}},"type":"object","required":["target_month","actual_price","expected_price","sj_score","signal_strength","signals","confidence","reason_codes","summary_jp","drivers","model_meta"],"title":"SJScoreDetail"},"SJScoreModelMeta":{"properties":{"sample_months":{"type":"integer","title":"Sample Months"},"cif_lag":{"type":"integer","title":"Cif Lag"},"dom_lag":{"type":"integer","title":"Dom Lag"},"r2":{"type":"number","title":"R2"},"rmse":{"type":"number","title":"Rmse"}},"type":"object","required":["sample_months","cif_lag","dom_lag","r2","rmse"],"title":"SJScoreModelMeta"},"SJScoreSignals":{"properties":{"cpi_signal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cpi Signal"},"cost_signal":{"type":"string","title":"Cost Signal"},"combined":{"type":"string","title":"Combined"}},"type":"object","required":["cpi_signal","cost_signal","combined"],"title":"SJScoreSignals"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}