LocalRamp API Documentation
  • Introduction
  • Getting Started
  • Crypto On-ramp
    • Overview
    • Widget Pop-up
    • Full-page checkout
    • Get Limits
    • Get Supported currencies
    • Get Quote
    • List Payment Methods
    • Get Transaction State
  • CRYPTO OFF-RAMP
    • Overview
    • Direct API Sell
      • Instant Sell
      • Get Transaction State
      • Get Limits
      • Get Supported Currencies
      • Get Supported Payment Methods
      • Get Supported Banks
      • Get Crypto Balance
      • Get Rates
      • Verify Bank Account
    • Widget Sell
      • Full-page checkout
      • Widget Pop-up
      • Get Limits
      • Get Quote
      • Get Supported currencies
      • Get Supported Payment Methods
      • Get Transaction State
  • PAYMENTS ON-RAMP
    • Overview
    • Full-page checkout
    • Widget Pop-up
    • White-Label API (Direct Charge)
    • Rates and Fees
    • Get Limits
    • Get Supported Currencies
    • Get Supported Payment Method
    • Withdraw crypto
    • Verify crypto withdrawal
    • Verify transaction
    • Get USDT balance
    • KYC
      • BVN Verification
      • Send OTP
  • Institutional Onramp (>$100k)
    • Overview
    • Initiate transaction
    • Complete transaction
    • Fetch transation
    • Exchange Rate
  • CRYPTO SWAPS
    • Overview
    • Instant Swap
    • Get Transaction State
    • Get Limits
    • Get Supported Currencies
    • Get Rates
  • Webhooks
    • Introduction
    • Verification
    • Events
  • TEST INTEGRATION
    • Simulate Webhooks
      • Fiat received (onramp)
      • Crypto Sent (onramp)
      • Sell completed (offramp)
      • Swap completed
    • Demo transaction
      • Example Completed Buy
      • Example Completed Sell (Bank Account)
      • Example Completed Sell (Mobile Money)
      • Example Completed Swap
Powered by GitBook
On this page
  1. CRYPTO OFF-RAMP
  2. Widget Sell

Get Quote

Before initializing a sell widget transaction, you might want to know what price the token is being traded at. Make a GET request to the following endpoint.

https://api.localramp.co/v1/transaction/sell-widget/quote?from_currency=USDT&to_currency=NGN

The request takes from_currency and to_currency as query params.

With the following header

x-auth-token: <PUBLIC_KEY>

If the API call is successful, LocalRamp returns the following response:

{
    "status": "success",
    "data": {
        "rate": {
            "info": "conversion rate from USDT -> NGN",
            "amount": "1584.00"
        },
        "fee": {
            "info": "Localramp processing fee in NGN ",
            "amount": "300.00",
            "type": "FLAT"
        },
        "partner_fee": {
            "type": "PERCENT",
            "fee": 0
        }
    }
}

fee is what LocalRamp charges in local currency fiat i.e NGN, GHS. It will be deducted from whatever is to be paid out.

exchange_rate is the selling price of the coin.

partner_fee refers to extra fees you might wish to charge your users. This is automatically infused into the rates. Earnings from partner fees are sent straight to the USDT wallet on your dashboard weekly. To set this up, reach out to business@localramp.co

Rate Calculation

To calculate how much you would eventually receive for any sender amount

to_amount = (from_amount *exchange_rate) - fee

Rates for our off-ramp are locked, so you should expect to receive the exact amounts (except in rare cases with high volatility of asset)

PreviousGet LimitsNextGet Supported currencies

Last updated 1 year ago