貿易でPPF外消費

直線PPF、機会費用、交易条件

世界がXの国内機会費用より多くのYをX1単位に対して支払うなら、国はXに比較優位を持ち自由貿易下ではXに完全特化すべきです。支払うYがそれより少なければ比較優位はYにあります。交易条件がXの機会費用とちょうど等しいとき特化の厳密な価格シグナルはなく、利得を主張せず幾何だけ欲しい場合はこの計算機が明示的な specialize フラグを要求します。完全特化は生産をPPFの角に置き、貿易はその後、傾きが国内機会費用ではなく世界相対価格である直線的な消費可能性フロンティアに沿って国を動かします。二財の直線的な生産可能性フロンティアは切片 max_x と max_y で完全に記述されます。国内資源をすべて財Xに向ければ国はXを max_x 単位、Yはゼロを得ます。すべてYに向ければYを max_y、Xはゼロです。自給自足で実現可能な束は、非負の数量のもとで x を max_x で割ったものと y を max_y で割ったものの和が1以下です。したがってXをさらに1単位得る国内機会費用は、放棄するYの max_y を max_x で割った単位、Yをさらに1単位得る費用はXの max_x を max_y で割った単位です。交易条件 tot_y_per_x は、Xを1単位輸出するごとに世界市場が引き渡すYの単位数、すなわちYで表したXの相対世界価格です。この小国開放経済の比較優位は一つの比較で読めます。

入力契約、特化、応答フィールド

任意の specialize は auto、x、または y（既定 auto）です。auto は ToT がXの機会費用を超えるときXを、より小さいときYを選びます。POSTでJSON本体に、必須の正の有限数を三つ送ります。PPF切片の max_x と max_y、X1単位あたりの世界のY単位 tot_y_per_x です。任意の export_share は0より大きく1以下の数（既定は半分）で、特化財産出のうち輸出する割合です。任意の decimals は0から12の整数で、各計算フィールドの half-up 丸めを制御します（既定6）。欠落フィールド、非有限値、非正の切片や交易条件、単位半開区間外の export_share、許可集合外の specialize、ToT がXの機会費用と等しいときの auto モードはすべて invalid_input で失敗し課金されません。成功時の応答は入力をエコーし、opportunity_cost_x_in_y と opportunity_cost_y_in_x、recommended_specialize と specialized_in、生産の角、両財の輸出入フロー、消費束、CPF切片 cpf_max_x と cpf_max_y、consumption_x を max_x で割ったものと consumption_y を max_y で割ったものの和である ppf_index、真偽値 beyond_ppf、国内PPFに対する切片利得、世界価格でY建てした消費所得と自給所得、trade_gain_value_y、短い formula 文字列を報告します。例：max_x が100、max_y が50、tot_y_per_x が1、export_share が半分ならXに特化し、50のXを50のYと交換して各50を消費し、ppf_index は1.5となり、消費点は国内フロンティアの外にはっきり位置します。

PPF外消費の貿易APIが役立つ場面

実装は純粋 parse の tier A のため、成功した呼び出しはモデルトークンも外向きネットワークもなく公開の基本価格 $0.002 です。リクエストを小さく保ち、丸めた消費と ppf_index をテストに固定すれば、自前の完全な貿易シミュレーション基盤を立てずに宿題・LMSプラグイン・エッジワーカー向けの再現可能な貿易利得数値が得られます。