Skip to main content
POST
/
v1
/
transit
/
quote
curl --request POST \
  --url https://sandbox.api.fin.com/v1/transit/quote \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "order_amount": "100.00",
  "integration_type": "BYBIT",
  "settlement_config": {
    "settlement_via": "ONE_TO_ONE",
    "rebalance_fee": true,
    "destination_details": {
      "wallet_address": "SOLANA_WALLET_ADDRESS",
      "currency": "USDC",
      "rail": "SOLANA"
    }
  }
}
'
{
  "data": {
    "quote_id": "FIN_PROVIDED_UUID",
    "expire_at": 1770916749,
    "order_amount": "100.00",
    "integration_type": "BYBIT",
    "settlement_config": {
      "settlement_via": "ONE_TO_ONE",
      "rebalance_fee": true,
      "destination_details": {
        "wallet_address": "SOLANA_WALLET_ADDRESS",
        "currency": "USDC",
        "rail": "SOLANA"
      }
    },
    "quote_estimation": {
      "payment_fee": "0.50",
      "conversion_fee": "0.00",
      "withdrawal_fee": "1.00",
      "gas_fee": "0.50",
      "total_fee": "2.00",
      "total_order_amount": "100.00",
      "ata_fee_applied": true
    }
  }
}
Creates a quote with fee estimation for a transit payment. The quote provides a breakdown of all applicable fees before initiating a payment.

​
Settlement Configuration

Currently, the quote endpoint only supports USDC to USDC settlements on the Solana blockchain.
  • settlement_via: Must be ONE_TO_ONE
  • currency: Must be USDC
  • rail: Must be SOLANA

​
Rebalance Fee Behavior

The rebalance_fee flag determines how fees are applied to the order:
  • rebalance_fee: true — Fees are absorbed into the order amount. The total_order_amount equals the order_amount.
  • rebalance_fee: false — Fees are added on top of the order amount. The total_order_amount equals order_amount + total_fee.

​
Quote Estimation Fields

FieldDescription
payment_feeProcessing fee (e.g., 0.5% of total amount)
conversion_feeCurrency conversion fee (0.00 for same-currency settlements)
withdrawal_feeWithdrawal fee from the provider
gas_feeBlockchain gas fee including ATA creation cost if applicable
total_feeSum of all fees
total_order_amountFinal order amount (depends on rebalance_fee flag)
ata_fee_appliedWhether an Associated Token Account creation fee was included in the gas fee
The quote has a limited validity period indicated by the expire_at timestamp. A new quote must be generated if the previous one has expired.

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Obtain token from /v1/oauth/token endpoint

Body

application/json
​
order_amount
string
required

The order amount for the payment

Example:

"100.00"

​
integration_type
enum<string>
required

Integration provider type

Available options:
BYBIT
Example:

"BYBIT"

​
settlement_config
object
required

Settlement configuration for the payment

Response

Quote created successfully

​
data
object