Skip to main content
POST
/
api
/
v1
/
transactions
/
list
Get transactions
curl --request POST \
  --url https://integration-api.meshconnect.com/api/v1/transactions/list \
  --header 'Content-Type: application/json' \
  --header 'X-Client-Id: <api-key>' \
  --header 'X-Client-Secret: <api-key>' \
  --data '{
  "count": 20,
  "statuses": [
    "success"
  ],
  "authToken": "Secret authentication token",
  "type": "robinhood"
}'
{
  "content": {
    "transactions": [
      {
        "id": "17EC1243-D91A-48B6-B0CE-ECFDB134F8A0",
        "side": "buy",
        "symbol": "AAPL",
        "name": "APPLE INC",
        "assetType": "option",
        "paymentSymbol": "USD",
        "paymentType": "fiat",
        "amount": 1,
        "price": 120,
        "value": 120,
        "createdTimestamp": 1653215676,
        "updatedTimestamp": 1653215697,
        "status": "success",
        "orderType": "market",
        "timeInForce": "goodForDay",
        "brokerType": "robinhood",
        "transactionType": "order",
        "optionDetails": {
          "optionType": "call",
          "direction": "buyToOpen",
          "strikePrice": 200,
          "expirationTimestamp": 1673215697,
          "numberOfSharesInContract": 100,
          "complexOrderStrategyType": "NONE"
        }
      },
      {
        "id": "F9E932AE-A780-42F3-B887-82D888D594E5",
        "side": "sell",
        "symbol": "AAPL",
        "name": "APPLE INC",
        "assetType": "equity",
        "paymentSymbol": "USD",
        "paymentType": "fiat",
        "amount": 2,
        "price": 130,
        "value": 260,
        "createdTimestamp": 1651739676,
        "updatedTimestamp": 1651739781,
        "status": "success",
        "orderType": "market",
        "timeInForce": "goodTillCanceled",
        "brokerType": "robinhood",
        "transactionType": "order"
      },
      {
        "id": "9B5827E4-7D08-4A71-B4C0-B1B4E5562592",
        "side": "buy",
        "symbol": "BTC",
        "name": "Bitcoin",
        "assetType": "cryptocurrency",
        "paymentSymbol": "ETH",
        "paymentType": "cryptocurrency",
        "amount": 0.3,
        "price": 18604.8197,
        "value": 5581.44591,
        "createdTimestamp": 1651739676,
        "updatedTimestamp": 1651739781,
        "status": "success",
        "orderType": "limit",
        "timeInForce": "goodTillCanceled",
        "brokerType": "robinhood",
        "transactionType": "order"
      }
    ],
    "cursor": "N2VkZDI0MDMtNmRhYy01NThhLTk5NDUDYzI12M3GQ3ZmQ2",
    "total": 3,
    "earliestTimestamp": 1651739676
  },
  "status": "ok",
  "message": "",
  "errorHash": "410f5a714ec3ff858c578664aa05579f4a2034e2",
  "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
​
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 CexIo BinanceInternational Bitstamp GateIo Okx BitFlyer Coinlist Huobi Bitfinex KrakenDirect BinanceInternationalDirect Bybit CoinbasePrime RobinhoodConnect

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
​
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.

​
count
integer

Number of records to include in the response.

Default: 100

Maximum: 250

​
statuses
enum<string>[] | null

Return orders of this statuses only. If this field is not provided, orders with all available statuses will be returned.

​
from
integer | null

Return orders created after this timestamp. If this field is not provided, orders will be returned according to the default of the institution.

Response

Transactions 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