AIに「暗号資産の購入金額を計算するPythonコードを書いて」と頼むと、数行で動くコードが返ってきます。
ただし、実行できることと、計算の前提が正しいことは別です。金額を扱うコードでは、型だけでなく、通貨単位や手数料の扱いまで確認する必要があります。
この記事では、単純な現物購入の計算を例に、AI生成コードをレビューするときのポイントを整理します。
1. 計算式を書く前に、単位を決める
今回は次のモデルに限定します。
- 価格:1 BTCあたりのUSDT
- 数量:購入するBTCの数量
- 手数料:USDTで別途支払う金額
- 求める値:購入に必要なUSDTの合計
この条件なら、計算式は次のようになります。
購入金額 = 価格 × 数量 + 手数料
例えば、価格が60,000 USDT、数量が0.001 BTC、手数料が0.06 USDTなら、合計は60.06 USDTです。
ただし、手数料がBTC建てなら、そのままUSDTの金額に足すことはできません。
BYDFiなどの取引所データを扱う場合も、最初に確認したいのは各項目の単位です。価格の通貨、数量の通貨、手数料の通貨を別々に確認します。以下は説明用の独自形式であり、特定サービスのCSVやAPI仕様を再現したものではありません。
2. Decimalには文字列から値を渡す
Pythonのfloatでは、多くの十進小数を厳密に表現できません。
print(0.1 + 0.2)
# 0.30000000000000004
十進数として計算したい場合は、標準ライブラリのDecimalが選択肢になります。
from decimal import Decimal
print(Decimal("0.1") + Decimal("0.2"))
# 0.3
ここで大切なのは、Decimal(0.1)ではなく、Decimal("0.1")とすることです。
先にfloatへ変換すると、その時点の近似値を引き継ぐ可能性があります。CSVの文字列を読み取る場合も、途中でfloatを経由させないようにします。
3. 計算できない入力は明示的に止める
次の関数では、数値を文字列で受け取り、通貨の不一致や不正な値を拒否します。
from decimal import Decimal, localcontext
def purchase_cost(price, quantity, fee, *, quote, fee_currency):
if not all(isinstance(v, str) for v in (price, quantity, fee)):
raise TypeError("Pass decimal values as strings")
p, q, f = map(Decimal, (price, quantity, fee))
if not all(v.is_finite() for v in (p, q, f)):
raise ValueError("Values must be finite")
if p <= 0 or q <= 0 or f < 0:
raise ValueError("Require price > 0, quantity > 0, fee >= 0")
if fee_currency != quote:
raise ValueError("Convert the fee to quote currency first")
with localcontext() as ctx:
ctx.prec = 40
return p * q + f
result = purchase_cost(
"60000",
"0.001",
"0.06",
quote="USDT",
fee_currency="USDT",
)
print(result)
# 60.060
60.060と60.06は、数値としては同じです。表示桁数の調整と計算処理は分けて考えます。
また、Decimalも無制限の精度を保証するものではありません。この例では有効桁数を40に設定していますが、実際の入力範囲に合わせた設計が必要です。
4. 正常系以外の入力も確認する
レビューでは、期待する結果が出る例だけでなく、受け入れるべきでない入力も試します。
| 入力条件 | この関数の期待動作 |
|---|---|
| 60,000 × 0.001 + 0.06 | 60.06になる |
| 0.1 × 0.2、手数料ゼロ | 0.02になる |
| 価格がNaN | 拒否する |
| 数量がゼロ | 拒否する |
| 手数料が負数 | 拒否する |
| USDTの購入額にBTCの手数料を加える | 拒否する |
| 数値をfloatで渡す | 拒否する |
このサンプルでは、上記7ケースをPython 3.14.3で確認しています。
例えば、正常系は次のように検証できます。前のコードと同じファイルに追加して実行します。
assert purchase_cost(
"60000",
"0.001",
"0.06",
quote="USDT",
fee_currency="USDT",
) == Decimal("60.06")
assert purchase_cost(
"0.1",
"0.2",
"0",
quote="USDT",
fee_currency="USDT",
) == Decimal("0.02")
なお、負の手数料を拒否するのは、このモデルがリベートを扱わないためです。返金や手数料還元を扱うなら、仕様とテストを追加する必要があります。
また、数値として解釈できない文字列を渡した場合は、Decimalの変換時にInvalidOperationが発生します。実際のアプリケーションでは、入力エラーをどこで捕捉し、利用者にどう伝えるかも設計します。
5. この計算だけでは扱えないもの
実際の取引記録を処理する場合は、さらに確認する項目があります。
- 手数料が購入した資産から差し引かれる場合
- 注文が複数の価格で約定する場合
- 取引所が適用する数量・金額の丸め規則
- 手数料を別通貨で支払う場合の換算方法
この関数が求めるのは、限定した条件での購入金額です。損益計算、税務上の取得価額、先物の証拠金計算には、そのまま使用できません。
AIにコードを依頼するときも、「金額を計算して」だけで終わらせず、入力の単位、許容する値、対象外のケースまで伝えると、レビューすべき点が明確になります。
短い計算コードほど、式の外側にある前提を確認しておきたいところです。
関連記事
AIによるコード変更を検証するというテーマでは、次の記事も参考になります。本記事のサンプルコードは独立した例です。