POST
/api/quoteLive操作の見積もり
売却の完全な内訳を返します：使用された中間市場レート、各手数料を個別の行で、正味金額、実際に得られた実効レート。各行の合計は総額と正味額の差と正確に一致します。この不変条件はレスポンスが送信される前にチェックされ、不均衡なレスポンスが返されることはありません。
認証: 本日はありません。見積もりエンドポイントは公開されています。見積もりは個人データを明らかにしません。
パラメータ
| フィールド | 型 | 説明 |
|---|---|---|
assetId必須 | string | 入金アセットの識別子。例：「btc」、「usdt」、「sol」。 |
railId必須 | string | 支払い方法の識別子。例：「sepa_instant」、「br_pix」、「ke_mpesa」。 |
networkId | string | 入金ネットワーク。オプション：デフォルトではアセットの最初のネットワークが使用されます。ネットワークコストはネットワーク間で大きく異なるため、このフィールドは正味金額を変更します。 |
direction必須 | "sell" | "receive" | 入力方向。「sell」：金額は入金する額。「receive」：金額は受け取りたい額で、必要な入金額は二分探索で決定されます。 |
amount必須 | string | メジャーユニットでの金額。文字列として送信されます。JSON浮動小数点数は大きな金額でマイナーユニットを失う可能性があります：文字列は、クライアントとサーバーがセント単位まで一致する唯一の形式です。 |
curl -sS -X POST https://fiatside.com/api/quote \
-H 'Content-Type: application/json' \
-d '{
"assetId": "usdt",
"railId": "sepa_instant",
"networkId": "tron",
"direction": "sell",
"amount": "1000"
}'{
"deposit": { "amount": "1000.000000", "ticker": "USDT", "decimals": 6 },
"gross": "921.68",
"net": "912.28",
"currency": "EUR",
"currencyDecimals": 2,
"midRate": "0.92168430",
"effectiveRate": "0.91228000",
"totalCostBps": 102,
"lines": [
{ "code": "network", "amount": "1.11", "basis": "Cout reseau tron, preleve en USDT" },
{ "code": "spread", "amount": "8.29", "basis": "0.90 % du montant converti" }
],
"settlement": { "p50Minutes": 1, "p95Minutes": 12 },
"lockSeconds": 1800,
"rateAsOf": 1788356981608,
"rateSource": "mock",
"limitError": null
}- レスポンスにはCache-Control: no-storeが含まれます。キャッシュされた見積もりは、確定価格として提供される古い価格です。
- 決済手段の制限違反はHTTPエラーではありません：見積もりはlimitErrorオブジェクトとともに返され、below_minまたはabove_maxコードと正確な制限が含まれるため、インターフェースは2回目の呼び出しなしで適切なメッセージを表示できます。
- rateSourceは価格の出所を示します。値「mock」は決定論的な開発用ソースです：本番環境では起動できず、プロセスは凍結された価格を見積もる代わりに起動を拒否します。
考えられるエラー: invalid_request, unknown_asset_or_rail, rail_not_open, asset_not_offered, invalid_amount, rate_stale, rate_unavailable, quote_failed. 完全なカタログ