Skip to main content
GET
/
api
/
v0
/
transactions-pages
Get paginated transactions
curl --request GET \
  --url https://api.example.com/api/v0/transactions-pages \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "originAsset": "nep141:eth-0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48.omft.near",
      "destinationAsset": "nep141:17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1",
      "depositAddress": "GDJ4JZXZELZD737NVFORH4PSSQDWFDZTKW3AIDKHYQG23ZXBPDGGQBJK",
      "depositMemo": "12345",
      "depositAddressAndMemo": "GDJ4JZXZELZD737NVFORH4PSSQDWFDZTKW3AIDKHYQG23ZXBPDGGQBJK_12345",
      "recipient": "somebody.near",
      "status": "SUCCESS",
      "createdAt": "2025-12-31T12:00:00.000Z",
      "createdAtTimestamp": 1767182400,
      "intentHashes": "GnGk38hvi92tTWDYMMS8CWYnVT4fixmfBrnqSErCDMTu",
      "referral": "some-referral",
      "amountInFormatted": "22.130108",
      "amountOutFormatted": "22.113697",
      "appFees": [
        {
          "fee": 50,
          "recipient": "some.near"
        },
        {
          "fee": 5,
          "recipient": "somebody.near"
        }
      ],
      "nearTxHashes": [
        "6XqqDwoaopgg39QsEiFGs9HfwP2Vum9tCCyqHDYXWBBH",
        "EVcgKukwf38XsYcgvkEgiMPWR7qwLfLK5rsVtjgctPBn"
      ],
      "originChainTxHashes": [
        "0x9bcff372aee89b648c922b850573b22387c31d693079f5e37cd255814e2d615a"
      ],
      "destinationChainTxHashes": [
        "0x9bcff372aee89b648c922b850573b22387c31d693079f5e37cd255814e2d615a"
      ],
      "amountIn": "22130108",
      "amountInUsd": "22.1272",
      "amountOut": "22113697",
      "amountOutUsd": "22.1108",
      "refundTo": "somebody.near",
      "senders": [
        "0x1234567890abcdef1234567890abcdef12345678"
      ],
      "refundReason": "AMOUNT_MORE_THAN_BALANCE"
    }
  ],
  "totalPages": 50,
  "page": 1,
  "perPage": 50,
  "total": 2500,
  "nextPage": 2,
  "prevPage": null
}
Retrieve historical 1Click Swap transactions with page-based pagination. Ideal for building paginated UIs and handling large datasets with known page counts.
Use totalPages and nextPage/prevPage fields to build pagination controls in your UI.

Authorizations

​
Authorization
string
header
required

JWT token for API authentication.

Query Parameters

​
page
number

Page number. Default: 1. Min: 1.

Required range: x >= 1
​
perPage
number

Number of transactions per page. Default: 50. Max: 1000. Min: 1.

Required range: 1 <= x <= 1000
​
search
string

Search by deposit address, recipient, sender, or tx hash.

​
fromChainId
enum<string>

Filter by origin chain ID. Swap-specific: setting this excludes masking transactions.

Available options:
near,
eth,
base,
arb,
btc,
sol,
ton,
doge,
xrp,
zec,
gnosis,
bera,
bsc,
pol,
tron,
sui,
op,
avax,
cardano,
stellar,
aptos,
ltc,
monad,
xlayer,
starknet,
bch,
adi,
plasma,
scroll,
aleo,
dash
​
fromTokenId
string

Filter by origin token ID. Overrides fromChainId. Swap-specific: setting this excludes masking transactions.

​
toChainId
enum<string>

Filter by destination chain ID. Swap-specific: setting this excludes masking transactions.

Available options:
near,
eth,
base,
arb,
btc,
sol,
ton,
doge,
xrp,
zec,
gnosis,
bera,
bsc,
pol,
tron,
sui,
op,
avax,
cardano,
stellar,
aptos,
ltc,
monad,
xlayer,
starknet,
bch,
adi,
plasma,
scroll,
aleo,
dash
​
toTokenId
string

Filter by destination token ID. Overrides toChainId. Overrides fromTokenId. Swap-specific: setting this excludes masking transactions.

​
depositMemo
string

Deposit memo to narrow search by deposit address.

​
referral
string

Filter by referral. Swap-specific: setting this excludes masking transactions.

​
affiliate
string

Filter by an affiliate stored in the fees. Swap-specific: setting this excludes masking transactions.

​
statuses
string

Filter by comma-separated statuses. Allowed values: FAILED, INCOMPLETE_DEPOSIT, PENDING_DEPOSIT, PROCESSING, REFUNDED, SUCCESS. Default: FAILED, PROCESSING, REFUNDED, SUCCESS.

​
showTestTxs
string

Show transactions from test accounts and with test-related referrals.

​
minUsdPrice
number | null

Filter by minimum USD price for both input and output amounts. Swap-specific: setting this excludes masking transactions.

Required range: x >= 0
​
maxUsdPrice
number | null

Filter by maximum USD price for both input and output amounts. Swap-specific: setting this excludes masking transactions.

Required range: x >= 0
​
endTimestamp
string<date-time> | null

Filter by end timestamp (non-inclusive). Use ISO 8601 format.

​
endTimestampUnix
number | null

Filter by end timestamp (non-inclusive). Use Unix timestamp.

​
startTimestamp
string<date-time> | null

Filter by start timestamp (non-inclusive). Use ISO 8601 format.

​
startTimestampUnix
number | null

Filter by start timestamp (non-inclusive). Use Unix timestamp.

Response

Transactions

​
data
object[]
required
​
totalPages
number
required
Example:

50

​
page
number
required
Example:

1

​
perPage
number
required
Example:

50

​
total
number
required
Example:

2500

​
nextPage
number | null
required
Example:

2

​
prevPage
number | null
required
Example:

null