Skip to Content
Symmio Trading-SDK — the SDK surface for builders on Arbitrum
CorePoolsgetPoolTransactions

getPoolTransactions

Fetch a pool’s deposit and withdrawal history, newest first — refunded deposits included.

import { getPoolTransactions } from "@symmio/trading-core";
 
const page = await getPoolTransactions(config, {
  marketAddress: "0x800822d361335b4d5F352Dac293cA4128b5B605f",
  size: 50,
});

Public and pool-wide by default: every LP’s rows, not just the caller’s. Pass walletAddress to narrow it to one wallet.

Unlike the other pool tables, this one has rows before the pool is tradable — deposits exist from the moment a listing is applied for, while the quote and history tables need a symbolId.

Parameters

chainIdnumberoptional

Target chain id. Defaults to the config’s defaultChainId.

marketAddressstringrequired

The pool’s token contract address.

walletAddressstringoptional

Narrow the page to one wallet’s rows. Omit for the pool’s whole history across every LP.

startnumberoptional

Row offset. Defaults to 0.

sizenumberoptional

Page size. Defaults to 150.

Pagination is path-based (/{start}/{size}), not query-based.

Returns

PoolTransactionPage:

marketAddressstring

The pool’s token contract address, echoed by the backend.

countnumber

Total rows matching the query across all pages — so this is what a pager divides, not items.length.

itemsPoolTransaction[]

The rows themselves.

Each PoolTransaction:

transactionIdstring

Backend id for the transaction.

walletAddressstring

The wallet that made it. Varies row to row.

amountbigint

Amount moved, in the transaction’s own denomination.

usdcAmountbigint

Collateral value moved, USD.

tokenAmountbigint

Token amount moved, in the pool token’s units.

transactionHashstring | null

On-chain hash or Solana signature, when known.

refundAddressstring | null

Address a refund was sent to; null when not a refund.

refundTransactionHashstring | null

Hash of the refund transaction; null when not a refund.

refundTimenumber | null

When the refund completed, Unix seconds; null when not a refund.

typePoolTransactionType

DEPOSIT or WITHDRAW.

statusPoolTransactionStatus

PENDING, SUCCESS, REJECTED, REFUND or CANCELED.

timenumber

When the transaction happened, Unix seconds.

Throws

  • LISTING_NOT_CONFIGURED — a SymmError (kind: "config") when the chain has no listing backend.
  • UNSUPPORTED_CHAIN — a SymmError (kind: "config") for an unknown chain id.
  • FETCH_POOL_TRANSACTIONS_FAILED — an axios failure becomes a SymmApiError; a non-axios throw becomes a plain SymmError (kind: "api").
Last updated on
getPoolTradeHistorygetPoolRewardChart