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 | 주요 단위의 금액으로, STRING으로 전송됩니다. JSON float는 큰 금액에서 소수 단위를 잃을 수 있습니다: 문자열만이 클라이언트와 서버가 센트까지 일치하는 유일한 형식입니다. |
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 오류가 아닙니다: 견적은 below_min 또는 above_max 코드와 정확한 한도를 포함하는 limitError 객체와 함께 반환되므로, 인터페이스는 두 번째 호출 없이 올바른 메시지를 표시할 수 있습니다.
- rateSource는 가격이 어디서 왔는지 나타냅니다. 값 "mock"은 결정적 개발 소스입니다: 프로덕션에서는 부팅할 수 없으며, 프로세스는 고정 가격을 견적하는 대신 시작을 거부합니다.
가능한 오류: invalid_request, unknown_asset_or_rail, rail_not_open, asset_not_offered, invalid_amount, rate_stale, rate_unavailable, quote_failed. 전체 카탈로그