---
title: "Create a crypto payment quote"
method: POST
path: "/v1/transit/quote"
tags: ["Crypto Orchestration"]
---

# Create a crypto payment quote

`POST /v1/transit/quote`

Generate a fee estimation quote for a transit payment

## Request body

- union
  - object
    - `order_amount` string, required — Order amount in USD.
    - `integration_type` 'BYBIT', required
    - `settlement_config` object, required
      - `settlement_via` 'MARKET_ORDER' | 'ONE_TO_ONE', required
      - `rebalance_fee` boolean, required — When true, fees are absorbed and total_order_amount equals order_amount. When false, settlement_amount equals order_amount minus total_fee.
      - `destination_details` object, required
        - `wallet_address` string, required — Destination wallet address.
        - `currency` 'USDC' | 'PYUSD', required — Destination currency. See [supported chains and currencies](https://developer.fin.com/crypto-orchestration/integration-types/bybit#chains-rails-and-constraints) for valid currency and rail combinations.
        - `rail` 'SOLANA' | 'ETHEREUM' | 'BASE', required
  - object
    - `order_amount` string, required — Order amount in USD.
    - `integration_type` 'KRAKEN', required
    - `settlement_config` object, required
      - `settlement_via` 'ONE_TO_ONE', required
      - `rebalance_fee` boolean, required — When true, fees are absorbed and total_order_amount equals order_amount. When false, settlement_amount equals order_amount minus total_fee.
      - `destination_details` object, required
        - `wallet_address` string, required — Destination wallet address.
        - `currency` 'USDC' | 'PYUSD', required
        - `rail` 'SOLANA', required
    - `developer_fee` object, nullable — Developer fee configuration. Nullable. Both fields default to 0.
      - `fixed` string — Fixed fee in USD per transaction. Defaults to 0.
      - `percentage` string — Percentage fee applied to order_amount. Defaults to 0.
  - object
    - `order_amount` string, required — Order amount in USD.
    - `integration_type` 'PASS_THROUGH', required
    - `settlement_config` object, required
      - `settlement_via` 'FEE_RETENTION', required
      - `rebalance_fee` boolean, required — Only false is supported for PASS_THROUGH. Passing true returns an error.
      - `destination_details` object, required
        - `wallet_address` string, required — Destination wallet address.
        - `currency` 'BTC' | 'ETH' | 'USDT' | 'USDC', required
        - `rail` 'BITCOIN' | 'ETHEREUM' | 'TRON' | 'SOLANA', required
    - `developer_fee` object, nullable — Developer fee configuration. Nullable. Both fields default to 0.
      - `fixed` string — Fixed fee in USD per transaction. Defaults to 0.
      - `percentage` string — Percentage fee applied to order_amount. Defaults to 0.
  - object
    - `order_amount` string, required — Order amount in USD.
    - `integration_type` 'OKX', required
    - `settlement_config` object, required
      - `settlement_via` 'ONE_TO_ONE', required
      - `rebalance_fee` boolean, required — When true, fees are absorbed and total_order_amount equals order_amount. When false, settlement_amount equals order_amount minus total_fee.
      - `destination_details` object, required
        - `wallet_address` string, required — Destination wallet address.
        - `currency` 'USDC', required — USDC only for OKX (milestone-1).
        - `rail` 'SOLANA', required — SOLANA only for OKX (milestone-1).
    - `developer_fee` object, nullable — Developer fee configuration. Nullable. Both fields default to 0.
      - `fixed` string — Fixed fee in USD per transaction. Defaults to 0.
      - `percentage` string — Percentage fee applied to order_amount. Defaults to 0.

## Response `200`

Quote created successfully

- union
  - object
    - `data` object
      - `quote_id` string, uuid — Unique quote identifier. Pass as quote_id when creating a payment to lock in the quoted fees.
      - `expire_at` integer — Unix timestamp when this quote expires. Request a new quote after expiry.
      - `order_amount` string — Order amount provided in the request, in USD.
      - `integration_type` string
      - `settlement_config` object
        - `settlement_via` string
        - `rebalance_fee` boolean
        - `destination_details` object
          - `wallet_address` string
          - `currency` string
          - `rail` string
      - `quote_estimation` object
        - `payment_fee` string — Fee charged by the exchange for processing the payment.
        - `conversion_fee` string — Fee charged for currency conversion where applicable.
        - `withdrawal_fee` string — Fee charged for withdrawing funds from the exchange.
        - `gas_fee` string — Blockchain network gas fee for the on-chain settlement transaction.
        - `total_fee` string — Total of all fees: gas_fee + payment_fee + conversion_fee + withdrawal_fee.
        - `total_order_amount` string — Gross amount charged to the payer. When rebalance_fee is true, equals order_amount (fees absorbed into the order).
        - `ata_fee_applied` boolean — Whether a Solana Associated Token Account creation fee was applied to gas_fee.
  - object
    - `data` object
      - `quote_id` string, uuid — Unique quote identifier. Pass as quote_id when creating a payment to lock in the quoted fees.
      - `expire_at` integer — Unix timestamp when this quote expires. Request a new quote after expiry.
      - `order_amount` string — Order amount provided in the request, in USD.
      - `integration_type` string
      - `settlement_config` object
        - `settlement_via` string
        - `rebalance_fee` boolean
        - `destination_details` object
          - `wallet_address` string
          - `currency` string
          - `rail` string
      - `quote_estimation` object
        - `payment_fee` string — Fee charged by the exchange for processing the payment.
        - `conversion_fee` string — Fee charged for currency conversion where applicable.
        - `withdrawal_fee` string — Fee charged for withdrawing funds from the exchange.
        - `gas_fee` string — Blockchain network gas fee for the on-chain settlement transaction.
        - `total_developer_fee` string — Sum of developer-configured fees: fixed fee plus percentage of order_amount.
        - `total_fee` string — Total of all fees: gas_fee + payment_fee + conversion_fee + withdrawal_fee + total_developer_fee.
        - `total_order_amount` string — Gross amount charged to the payer. When rebalance_fee is false, settlement_amount equals order_amount minus total_fee.
        - `ata_fee_applied` boolean — Whether a Solana Associated Token Account creation fee was applied to gas_fee.
  - object
    - `data` object
      - `quote_id` string, uuid — Unique quote identifier. Pass as quote_id when creating a payment to lock in the quoted fees.
      - `expire_at` integer — Unix timestamp when this quote expires. Request a new quote after expiry.
      - `order_amount` string — Order amount provided in the request, in USD.
      - `integration_type` string
      - `settlement_config` object
        - `settlement_via` string
        - `rebalance_fee` boolean
        - `destination_details` object
          - `wallet_address` string
          - `currency` string
          - `rail` string
      - `quote_estimation` object
        - `payment_fee` string — Fee charged by the exchange for processing the payment.
        - `conversion_fee` string — Fee charged for currency conversion where applicable.
        - `withdrawal_fee` string — Fee charged for withdrawing funds from the exchange.
        - `gas_fee` string — Blockchain network gas fee for the on-chain settlement transaction.
        - `total_developer_fee` string — Sum of developer-configured fees: fixed fee plus percentage of order_amount.
        - `total_fee` string — Total of all fees: gas_fee + payment_fee + conversion_fee + withdrawal_fee + total_developer_fee.
        - `total_order_amount` string — Gross amount charged to the payer. When rebalance_fee is false, settlement_amount equals order_amount minus total_fee.
        - `ata_fee_applied` boolean — Whether a Solana Associated Token Account creation fee was applied to gas_fee.
  - object
    - `data` object
      - `quote_id` string, uuid — Unique quote identifier. Pass as quote_id when creating a payment to lock in the quoted fees.
      - `expire_at` integer — Unix timestamp when this quote expires. Request a new quote after expiry.
      - `order_amount` string — Order amount provided in the request, in USD.
      - `integration_type` string
      - `settlement_config` object
        - `settlement_via` string
        - `rebalance_fee` boolean
        - `destination_details` object
          - `wallet_address` string
          - `currency` string
          - `rail` string
      - `quote_estimation` object
        - `payment_fee` string — Fee charged by the exchange for processing the payment.
        - `conversion_fee` string — Fee charged for currency conversion where applicable.
        - `withdrawal_fee` string — Fee charged for withdrawing funds from the exchange.
        - `gas_fee` string — Blockchain network gas fee for the on-chain settlement transaction.
        - `total_developer_fee` string — Sum of developer-configured fees: fixed fee plus percentage of order_amount.
        - `total_fee` string — Total of all fees: gas_fee + payment_fee + conversion_fee + withdrawal_fee + total_developer_fee.
        - `total_order_amount` string — Gross amount charged to the payer. When rebalance_fee is false, settlement_amount equals order_amount minus total_fee.
        - `ata_fee_applied` boolean — Whether a Solana Associated Token Account creation fee was applied to gas_fee.

## Other responses

- `401` — Authentication failed due to invalid credentials

---

[API](https://skmtc.net/fin/apis/fin-com-api.md) · [All operations](https://skmtc.net/fin/apis/fin-com-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fin/fin-com-api/revisions/6e69503ee7b8/schema)