Get quote

Get a quote for transferring a fiat amount from a brokerage account in a given cryptocurrency over a specified network. Returns min and max fees and amounts to account for different funding sources (existing crypto balance, cash balance or ACH/debit deposit). Currently only supported for Coinbase.

POST /api/v1/transfers/managed/quote

cURL

Quote transfer with no partner fee

curl --request POST \
  --url https://integration-api.meshconnect.com/api/v1/transfers/managed/quote \
  --header 'Content-Type: application/json' \
  --header 'X-Client-Id: <api-key>' \
  --header 'X-Client-Secret: <api-key>' \
  --data '
{
  "amountInFiat": 10,
  "fiatCurrency": "USD",
  "symbol": "ETH",
  "networkId": "e3c7fdd8-b1fc-4e51-85ae-bb276e075611",
  "toAddress": "0xc096a91fDFB100ECED14e4810FA06061C0b3058B",
  "brokerType": "coinbase"
}
'

200

{
  "content": {
    "amountInFiat": 100,
    "fiatCurrency": "USD",
    "symbol": "ETH",
    "networkId": "e3c7fdd8-b1fc-4e51-85ae-bb276e075611",
    "toAddress": "0xc096a91fDFB100ECED14e4810FA06061C0b3058B",
    "brokerType": "coinbase",
    "isEligible": true,
    "minEligibleAmount": 0.0001,
    "minEligibleAmountFiat": 0,
    "brokerPrice": 2247.5,
    "price": 2246.9,
    "minAmountFiat": 97.08,
    "maxAmountFiat": 97.88,
    "minAmount": 0.04320807702278007,
    "maxAmount": 0.04356412313075105,
    "fees": {
      "inFiat": {
        "paymentMethodFeeMaxFiat": 0,
        "tradingFeeMaxFiat": 0.8,
        "withdrawalFeeFiat": 0,
        "partnerFeeFiat": 1,
        "networkFeeFiat": 1.12,
        "minFeesFiat": 2.12,
        "maxFeesFiat": 2.92
      },
      "inCrypto": {
        "paymentMethodFeeMax": 0,
        "tradingFeeMax": 0.00035604610797098225,
        "withdrawalFee": 0,
        "partnerFee": 0.0004450576349637278,
        "networkFee": 0.000496582730658,
        "minFees": 0.0009416403656217278,
        "maxFees": 0.0012976864735927101
      }
    },
    "fundingOptions": [
      {
        "fundingOption": "existingCryptocurrencyBalance",
        "paymentMethodFeeFiat": 0,
        "tradingFeeFiat": 0
      },
      {
        "fundingOption": "buyingPowerPurchase",
        "paymentMethodFeeFiat": 0,
        "tradingFeeFiat": 0.8
      },
      {
        "fundingOption": "paymentMethodDepositUsage",
        "paymentMethodType": "bankAccount",
        "paymentMethodFeeFiat": 0,
        "tradingFeeFiat": 0.8
      }
    ]
  },
  "status": "ok",
  "message": "",
  "errorHash": "6aa95595",
  "teamCode": "P4",
  "errorType": ""
}

{
  "status": "badRequest",
  "message": "Error message",
  "displayMessage": "Optional display message",
  "errorHash": "7dcbb73d",
  "teamCode": "P4",
  "errorType": "missingField"
}

Authorizations

X-Client-Secret · string · header · required

Contact Mesh to get client Secret

X-Client-Id · string · header · required

Contact Mesh to get client Id

Body

application/json

amountInFiat · number<double> · required

Base amount of fiat currency being transferred

fiatCurrency · string · required

3 character currency code, e.g. USD

Maximum string length: 3

symbol · string · required

Symbol of destination cryptocurrency, e.g. ETH

Maximum string length: 10

networkId · string<uuid> · required

Unique id of destination network

toAddress · string · required

The designated destination for sending the asset.

Maximum string length: 1024

brokerType · enum<string> · required

The type of the integration to send the asset from

Available options: robinhood, eTrade, alpaca, tdAmeritrade, weBull, stash, interactiveBrokers, public, coinbase, kraken, coinbasePro, cryptoCom, openSea, binanceUs, gemini, cryptocurrencyAddress, cryptocurrencyWallet, okCoin, bittrex, kuCoin, etoro, cexIo, binanceInternational, bitstamp, gateIo, acorns, okx, bitFlyer, coinlist, huobi, bitfinex, deFiWallet, krakenDirect, vanguard, binanceInternationalDirect, bitfinexDirect, bybit, paxos, coinbasePrime, btcTurkDirect, kuCoinDirect, okxOAuth, paribuDirect, robinhoodConnect, blockchainCom, bitsoDirect, binanceConnect, binanceOAuth, revolutConnect, binancePay, bybitDirect, paribuOAuth, payPalConnect, binanceTrDirect, coinbaseRamp, bybitDirectMobile, sandbox, cryptoComPay, bybitEuDirect, uphold, binancePayOnchain, sandboxCoinbase, bybitPay, krakenOAuth, bluvoKrakenOAuth, cashApp, sandboxKrakenOAuth, krakPay, unlimit, alchemyPay, okxPay

feeFlat · number<double> | null

Flat fee in crypto to be charged as a partner fee

feePercentage · number<double> | null

Percentage of transfer amount to be charged as a partner fee, expressed as decimal (ie 0.1 = 10%)

Response

200

application/json

Quote obtained.

status · enum<string>

Available options: ok, serverFailure, permissionDenied, badRequest, notFound, conflict, tooManyRequest, locked, unavailableForLegalReasons

message · string | null

A message generated by the API

displayMessage · string | null

User-friendly display message that can be presented to the end user

errorHash · string | null · read-only

An error grouping hash from string components and caller information. Used by bugsnag on FE for correct error grouping

teamCode · string | null · read-only

Opaque team code for error routing. Resolved from exception origin or caller file path via CODEOWNERS. Format: 2-character code (e.g., "7K", "M2"). Use for alerting/routing, not display.

errorType · string | null

Strictly-typed error type that is explaining the reason of an unsuccessful status of the operation. All possible error types are available in the documentation.

errorData · unknown

content · object | null

Show child attributes