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

getPoolTransactions

Fetch pool deposit and withdrawal history, newest first — refunded deposits included — for one pool or across every pool.

import { getPoolTransactions, PoolTransactionStatus, PoolTransactionType } from "@symmio/trading-core"; // The latest activity across every pool — no filters. const latest = await getPoolTransactions(config); // One pool's pending withdrawals. const pending = await getPoolTransactions(config, { tokenAddress: "0x800822d361335b4d5F352Dac293cA4128b5B605f", transactionType: PoolTransactionType.WITHDRAW, transactionStatus: PoolTransactionStatus.PENDING, });

Public and unscoped by default: every LP’s rows on every pool, in one newest-first sequence. Every filter is optional and they combine — narrow by pool (tokenAddress), by the chain the pool’s token lives on (marketChainId), by wallet, by type, or by status. Each row names its own pool (tokenAddress, chainId), so an all-pools page stays attributable row by row.

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.

Ordering and pagination

  • Newest first, fixed. The service orders every page by time, newest first, across all pools. There is no sort parameter — the order is the same whatever the filters.
  • Path-based paging. start and size travel in the path (/{start}/{size}), not the query string. start counts rows, not pages: page n (0-based) is start: n * size, and /2/50 is the first page shifted by two rows, not page 3. count is the total matching the filters across all pages, so it is what a pager divides — not items.length. A start past count returns an empty page with count intact.
  • Capped page size. The backend caps size at 50 and rejects a larger value with a 422. The default is that cap.

Parameters

chainIdnumberoptional

Target chain id. Defaults to the config’s defaultChainId. Selects which deployment’s listing backend is asked — it is not a filter; marketChainId is.

tokenAddressstringoptional

Narrow to one pool by its token contract address (ListingMarket.contractAddress). Omit for every pool. EVM addresses match case-insensitively; Solana base58 addresses are case-sensitive. An address with no listed market fails with a 400 (Market not found) rather than returning an empty page.

marketAddressstringoptional

Deprecated — prefer tokenAddress. The same filter under its old name. It keeps working: the SDK sends it as token_address too, so it is unaffected if the service retires its own market_address alias. When both are set, tokenAddress wins.

marketChainIdListingDepositChainIdoptional

Narrow to pools whose token lives on this chain (ListingMarket.chainId). The service rejects a chain outside its supported deposit chains (getListingConfig) with a 422.

walletAddressstringoptional

Narrow to one wallet’s rows. Omit for every LP’s.

transactionTypePoolTransactionTypeoptional

Narrow to deposits or withdrawals only. Omit for both.

transactionStatusPoolTransactionStatusoptional

Narrow to one status (e.g. only REFUND). Omit for all statuses.

startnumberoptional

Row offset. Defaults to 0.

sizenumberoptional

Page size. Defaults to 50, which is also the backend’s cap.

Migrating from marketAddress

Rename the parameter — the result is the same:

// Before await getPoolTransactions(config, { marketAddress: address }); // After await getPoolTransactions(config, { tokenAddress: address });

marketAddress was required before; with every filter optional, omitting both reads every pool.

Returns

Promise<PoolTransactionPage>
marketAddressstring | null

The token address the page was narrowed to, echoed by the backend in its canonical form, or null when the page spans every pool. Each row carries its own tokenAddress either way.

countnumber

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

itemsPoolTransaction[]

The rows themselves, newest first.

Each PoolTransaction:

transactionIdstring

Backend id for the transaction.

tokenAddressstring

The pool’s token contract address (EVM 0x… or Solana base58) — the pool this row belongs to.

The chain the pool’s token lives on — not the chain the market trades on.

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.

A row carries the pool’s identity but not its display metadata. To label an all-pools page with names and tickers, join each row to its ListingMarket from getListingMarkets on tokenAddress + chainId (contractAddress + chainId on the market).

Query options

import { getPoolTransactionsQueryOptions } from "@symmio/trading-core"; import { useQuery } from "@tanstack/react-query"; useQuery(getPoolTransactionsQueryOptions(config, { tokenAddress, size: 25, start: page * 25 }));

getPoolTransactionsQueryOptions(config, options) returns a TanStack options bag with a stable queryKey, the queryFn, and enabled. Every filter and the paging are part of the key, so differently filtered pages never share a cache entry. The deprecated marketAddress folds into tokenAddress in the key, so both spellings of one filter do share one. The pools write hooks (withdraw, cancel withdraw, refund) invalidate every key under the "getPoolTransactions" prefix.

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 carrying status, statusText and responseData; a non-axios throw becomes a plain SymmError (kind: "api"). Notable statuses:
    • 400 with responseData.error_message "Market not found" — the tokenAddress (or marketAddress) has no listed market. An unlisted pool is an error, not an empty page.
    • 422 — a filter value the service rejects (a malformed address, a marketChainId outside its supported deposit chains) or a size above 50.
Last updated on