Skip to main content

Transactions

GET /v1/transactions

Retrieve user's transaction history with advanced filtering options.

Required Permission: read:transactions

Request​

curl -X GET "https://connect.kryptos.io/api/v1/transactions?limit=10&order=desc" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "X-Client-Id: YOUR_CLIENT_ID" \
  -H "X-Client-Secret: YOUR_CLIENT_SECRET"

Query Parameters​

ParameterTypeDescription
walletIdstringFilter by wallet IDs (comma-separated)
currencyIdstringFilter by currency IDs (comma-separated)
trxIdstringSpecific transaction ID
isNftbooleanFilter NFT transactions
isMissingPricebooleanTransactions missing price data
isMissingPurchasebooleanTransactions missing purchase data
isEditedbooleanManually edited transactions
isManualbooleanManually created transactions
transactionTypestringTypes: swap, deposit, withdraw
labelstringLabels (comma-separated)
orderstringSort order: asc, desc
timeStartnumberStart timestamp (Unix ms)
timeEndnumberEnd timestamp (Unix ms)
limitnumberMax results (1-1000, default: 100)
offsetnumberNumber of records to skip (min: 0, default: 0)

Response​

{
  "message": "User transactions retrieved successfully",
  "data": [
    {
      "id": "trx_123",
      "transactionPlatfromId": "0xabc123...",
      "timestamp": 1640995200000,
      "label": "Swap",
      "description": "Swapped ETH for USDC",
      "incomingAssets": [
        {
          "asset": {
            "tokenId": "usd-coin",
            "symbol": "USDC",
            "publicName": "USD Coin",
            "type": "crypto"
          },
          "quantity": 3000,
          "price": 1.0,
          "baseCurrency": "USD",
          "timestamp": 1640995200000,
          "type": "incoming",
          "toAccount": {
            "provider": "MetaMask",
            "walletId": "wallet_123",
            "publicAddress": "0x742d35..."
          }
        }
      ],
      "outgoingAssets": [
        {
          "asset": {
            "tokenId": "ethereum",
            "symbol": "ETH",
            "publicName": "Ethereum",
            "type": "crypto"
          },
          "quantity": 1.5,
          "price": 2000,
          "baseCurrency": "USD",
          "timestamp": 1640995200000,
          "type": "outgoing",
          "fromAccount": {
            "provider": "MetaMask",
            "walletId": "wallet_123",
            "publicAddress": "0x742d35..."
          }
        }
      ],
      "fee": [
        {
          "asset": {
            "tokenId": "ethereum",
            "symbol": "ETH",
            "type": "crypto"
          },
          "quantity": 0.005,
          "price": 2000,
          "baseCurrency": "USD",
          "type": "fee"
        }
      ],
      "metadata": {
        "importSource": "API",
        "isManual": false,
        "isEdited": false,
        "isDefiTrx": false,
        "isNFTTrx": false
      },
      "tags": [],
      "ledger": [],
      "rawTrx": {}
    }
  ],
  "pagination": {
    "limit": 100,
    "offset": 0,
    "returned_count": 1
  },
  "user_id": "user_123",
  "timestamp": 1640995200000
}

Pagination​

The response includes a pagination object with the following fields:

FieldTypeDescription
limitnumberMaximum number of results requested
offsetnumberNumber of records skipped
returned_countnumberActual number of transactions returned

Pagination Example​

To retrieve transactions in pages of 50:

# First page
curl -X GET "https://connect.kryptos.io/api/v1/transactions?limit=50&offset=0" \
  -H "Authorization: Bearer ACCESS_TOKEN"

# Second page
curl -X GET "https://connect.kryptos.io/api/v1/transactions?limit=50&offset=50" \
  -H "Authorization: Bearer ACCESS_TOKEN"

# Third page
curl -X GET "https://connect.kryptos.io/api/v1/transactions?limit=50&offset=100" \
  -H "Authorization: Bearer ACCESS_TOKEN"

Transaction Labels​

Use these labels with the label query parameter to filter transactions.

LabelDescription
Add LiquidityAdding liquidity to a pool
AirdropsAirdrop received
ApproveToken approval transaction
IncomeGeneral income
BorrowBorrowing assets
Borrow InterestInterest paid on borrowed assets
Bridge ReceiveReceiving from cross-chain bridge
Bridge SendSending via cross-chain bridge
Bridge TransferCross-chain bridge transfer
BurnToken burn
BuyPurchase transaction
CashbackCashback reward
Casualty LossLoss due to casualty
Collateral DepositDepositing collateral
Collateral WithdrawalWithdrawing collateral
DeFi SwapDecentralized exchange swap
DonationsCharitable donation
ExpenseGeneral expense
FailedFailed transaction
Farming RewardsYield farming rewards
FeeTransaction fee
Fiat DepositFiat currency deposit
Fiat WithdrawalFiat currency withdrawal
Funding Fee PaidFutures funding fee paid
Funding Fee ReceivedFutures funding fee received
Futures ExpenseFutures trading expense
ICO investmentICO participation
IgnoreIgnored transaction
Incoming GiftGift received
TransferGeneral transfer
LendLending assets
LiquidationLiquidation event
LoanLoan received
Loan InterestInterest earned on loan
Loan PaybackLoan repayment
LostLost assets
Margin FeeMargin trading fee
MiningMining reward
Mint NFTNFT minting
NFT BuyNFT purchase
NFT SellNFT sale
Outgoing GiftGift sent
Realized LossRealized trading loss
Realized ProfitRealized trading profit
Resource StakingResource staking (e.g., EOS)
RewardGeneral reward
RoyaltiesRoyalty payment
SellSale transaction
Liquidity WithdrawalRemoving liquidity from pool
SpamSpam transaction
StakeStaking assets
UnstakeUnstaking assets
Staking RewardsStaking reward
Security Token Offering(STO)STO participation
StolenStolen assets
TradeGeneral trade
WithdrawalWithdrawal
DepositDeposit
PaymentPayment transaction
SwapToken swap
ForkBlockchain fork
WrapToken wrapping
UnwrapToken unwrapping
Buy (Fiat to Crypto)Fiat to crypto purchase
Sell (Crypto to Fiat)Crypto to fiat sale
Cross Chain SwapsCross-chain swap
Rex WithdrawalREX withdrawal (EOS)
Rex DepositREX deposit (EOS)
InterestInterest earned
EarnEarnings
Centralized StakeCEX staking
Centralized LendingCEX lending
Vault DepositVault deposit
Vault WithdrawalVault withdrawal
UnknownUnknown transaction type