Skip to main content
POST
/
api
/
v1
/
transfers
/
list
Get transfer history
curl --request POST \
  --url https://integration-api.meshconnect.com/api/v1/transfers/list \
  --header 'Content-Type: application/json' \
  --header 'X-Client-Id: <api-key>' \
  --header 'X-Client-Secret: <api-key>' \
  --data '{
  "authToken": "<string>",
  "type": "robinhood",
  "count": 123,
  "cursor": "<string>",
  "statuses": [
    "unknown"
  ],
  "cryptocurrencyAddressType": "ethAddress",
  "from": 123
}'
{
  "content": {
    "transfers": [
      {
        "id": "8E25ACB5-A9E2-4D00-8772-A255F010A2A9",
        "status": "succeeded",
        "type": "deposit",
        "fromAddress": "D5PumQwt...",
        "targetAddress": "D641Fmzx...",
        "symbol": "DOGE",
        "hash": "3310c6202aaeb44754a118ce11f255382d012060ade0d6d9f...",
        "amount": 15,
        "transactionAmount": 10,
        "createdTimestamp": 1653215600,
        "updatedTimestamp": 1653215600,
        "networkTransactionFee": {
          "amount": 5,
          "symbol": "DOGE"
        },
        "confirmations": 17,
        "blockchainMethod": "transfer"
      },
      {
        "id": "70E6E3CF-5ACF-49C5-A4E1-5FB85A567F26",
        "status": "succeeded",
        "type": "withdrawal",
        "fromAddress": "0x7BDE8361Fe587daD0e35448E754...",
        "targetAddress": "0x83C8F28c26bF6aaca652Df1DbBE...",
        "symbol": "ETH",
        "hash": "0x77f3a280aa5cfe956a5759c24cf774325504070b32b4159...",
        "amount": 0.1,
        "transactionAmount": 0.099,
        "createdTimestamp": 1653211113,
        "updatedTimestamp": 1653211113,
        "networkTransactionFee": {
          "amount": 0.001,
          "symbol": "ETH"
        },
        "confirmations": 18,
        "blockchainMethod": "transfer"
      }
    ],
    "total": 2,
    "cursor": "N2VkZDI0MDMtNmRhYy01NThhLTk5NDUDYzI12M3GQ3ZmQ2",
    "earliestTimestamp": 1653211113
  },
  "status": "ok",
  "message": "",
  "errorHash": "37c012c29d3ec88fdf5c8ecb48e857212a520151",
  "errorType": ""
}

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

Authentication token and integration type to obtain the list of transfers.

​
authToken
string
required

Auth token that allows connecting to the target institution

Minimum length: 1
​
type
enum<string>
required

Type of the institution to connect

Supported integrations:

Robinhood Coinbase Kraken CryptoCom Binance Gemini OkCoin KuCoin BinanceInternational Bitstamp GateIo Okx Huobi Bitfinex KrakenDirect BinanceInternationalDirect BitfinexDirect Bybit Paxos CoinbasePrime BtcTurkDirect ParibuDirect RobinhoodConnect BlockchainCom BinanceConnect RevolutConnect BinancePay BybitDirect ParibuOAuth PayPalConnect CoinbaseRamp BybitDirectMobile DeFiWallet

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
​
count
integer

Number of records to include in the response.

Default: 100

Maximum: 250

​
cursor
string | null

The cursor to retrieve the next page of transactions. Providing it will cause the response to only return changes after this update. If this field is not provided, the history of transactions will be returned starting with the first-added transaction.

​
statuses
enum<string>[] | null

If this value is provided, result set is filtered to only include transaction with the provided statuses.

​
cryptocurrencyAddressType
enum<string>

For cryptocurrency address the type of address is required.

Available options:
ethAddress,
btcAddress,
ltcAddress,
solAddress,
algoAddress,
celoAddress,
cardanoAddress,
polygonAddress,
bnbAddress,
elrondAddress,
neoAddress,
xrpAddress,
flowAddress,
harmonyOneAddress,
tronAddress,
dogeAddress,
opAddress
​
from
integer | null

If this value is provided, result set is filtered to only include transactions created after this timestamp

Response

Transfers 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

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

​
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
any
​
content
object
⌘I