Get transaction history

GET/v0/account/history

Needs Authorization: Bearer <accessToken>. Lists swaps where the account is the recipient, refundTo, sender or signer, newest first. Real response for a throwaway account that created two quotes (a swap quote and an order).

Returns paginated public and confidential transaction history. History is invite-only for now. For the initial request, omit both nextCursor and prevCursor to retrieve the latest history. For subsequent requests, pass either nextCursor or prevCursor from the previous response. Tidepool: needs a Tidepool JWT. Swaps where you are the refund address or recipient, newest first, with cursor paging.

Operation id: getHistory

Request

curl "https://www.usetidepool.tech/v0/account/history" \
  -H 'Authorization: Bearer <accessToken>'

Query parameters

Name	Type	Description
`prevCursor`	string	Pass the prevCursor value from a previous response to fetch older items. Omit both cursors for the initial request. Do not pass together with nextCursor.
`nextCursor`	string	Pass the nextCursor value from a previous response to poll for newer items. Omit both cursors for the initial request. Do not pass together with prevCursor.
`status`	"PENDING_DEPOSIT" \| "INCOMPLETE_DEPOSIT" \| "PROCESSING" \| "SUCCESS" \| "REFUNDED" \| "FAILED"[]	Filter by statuses
`limit`	integer	Maximum number of items to return per page
`depositAddress`	string	Filter by deposit address
`depositMemo`	string	Filter by deposit memo. Only has effect when depositAddress is also provided.
`search`	string	Search by deposit address, recipient, sender, or tx hash
`depositType`	"ORIGIN_CHAIN" \| "INTENTS" \| "CONFIDENTIAL_INTENTS" \| "null"[]	Correlated deposit type filter. Index-aligned with recipientType and refundType. Use "null" as a wildcard for that position. Multiple values form OR conditions.
`recipientType`	"DESTINATION_CHAIN" \| "INTENTS" \| "CONFIDENTIAL_INTENTS" \| "null"[]	Correlated recipient type filter. Index-aligned with depositType and refundType. Use "null" as a wildcard for that position.
`refundType`	"ORIGIN_CHAIN" \| "INTENTS" \| "CONFIDENTIAL_INTENTS" \| "null"[]	Correlated refund type filter. Index-aligned with depositType and recipientType. Use "null" as a wildcard for that position.

Responses

200

{
  "items": [
    {
      "status": "PENDING_DEPOSIT",
      "depositType": "INTENTS",
      "recipientType": "INTENTS",
      "createdAt": "2026-10-30T16:31:46.340Z",
      "depositAddress": "54e8db801fab4ec416719b8b3044c21bacb4652c698ad4c5846086e5cf27b3a4",
      "depositMemo": null,
      "originAsset": "nep141:usdc.tidepool-sandbox.testnet",
      "amountInFormatted": "5",
      "amountInUsd": "4.9988",
      "destinationAsset": "nep141:wnear.tidepool-sandbox.testnet",
      "amountOutFormatted": "1.146611853686635908",
      "amountOutUsd": "4.9763",
      "recipient": "9cf39ad040a13205c3ab109a8566fd779394a548f76b1aed5107efcdfe6c7ceb",
      "quoteTransactions": [],
      "refundTo": "9cf39ad040a13205c3ab109a8566fd779394a548f76b1aed5107efcdfe6c7ceb",
      "refundType": "INTENTS",
      "refundReason": null,
      "refundedAmountFormatted": "0",
      "refundedAmountUsd": "0",
      "refundFee": null,
      "refundFeeFormatted": "0"
    },
    {
      "status": "PENDING_DEPOSIT",
      "depositType": "INTENTS",
      "recipientType": "INTENTS",
      "createdAt": "2026-10-30T16:31:25.888Z",
      "depositAddress": "b3e013f41cee40b33296f5e0185feae34c2f95059a05482e07cb610acd067322",
      "depositMemo": null,
      "originAsset": "nep141:wnear.tidepool-sandbox.testnet",
      "amountInFormatted": "1",
      "amountInUsd": "4.3400",
      "destinationAsset": "nep141:usdc.tidepool-sandbox.testnet",
      "amountOutFormatted": "3.465",
      "amountOutUsd": "4.2880",
      "recipient": "9cf39ad040a13205c3ab109a8566fd779394a548f76b1aed5107efcdfe6c7ceb",
      "quoteTransactions": [],
      "refundTo": "9cf39ad040a13205c3ab109a8566fd779394a548f76b1aed5107efcdfe6c7ceb",
      "refundType": "INTENTS",
      "refundReason": null,
      "refundedAmountFormatted": "0",
      "refundedAmountUsd": "0",
      "refundFee": null,
      "refundFeeFormatted": "0"
    }
  ],
  "nextCursor": "MjAyNi0xMC0zMFQxNjozMTo0Ni4zNDBa",
  "prevCursor": "MjAyNi0xMC0zMFQxNjozMToyNS44ODha"
}

Field	Type	Required	Description
`items`	HistoryItem[]	yes	History items for the current page. When fetching older items (via prevCursor), fewer items than limit means you reached the end — no need to fetch further. For newer items (via nextCursor), new data can always appear later.
`items[].[]status`	"PENDING_DEPOSIT" \	"INCOMPLETE_DEPOSIT" \	"PROCESSING" \
`items[].[]depositType`	"ORIGIN_CHAIN" \	"INTENTS" \	"CONFIDENTIAL_INTENTS"
`items[].[]recipientType`	"DESTINATION_CHAIN" \	"INTENTS" \	"CONFIDENTIAL_INTENTS"
`items[].[]createdAt`	string	yes	Creation timestamp (ISO 8601)
`items[].[]depositAddress`	string	yes	Deposit address
`items[].[]depositMemo`	string	yes	Deposit memo
`items[].[]originAsset`	string		ID of the origin asset
`items[].[]amountInFormatted`	string		Amount of the origin asset in readable format
`items[].[]amountInUsd`	string		Amount of the origin asset equivalent in USD
`items[].[]destinationAsset`	string		ID of the destination asset
`items[].[]amountOutFormatted`	string		Amount of the destination asset in readable format
`items[].[]amountOutUsd`	string		Amount of the destination asset equivalent in USD
`items[].[]recipient`	string		Recipient address
`items[].[]quoteTransactions`	object[]		Deposit transactions with sender and tx hash
`items[].[]quoteTransactions[].[]sender`	string
`items[].[]quoteTransactions[].[]txHash`	string
`items[].[]refundTo`	string		Refund-to address
`items[].[]refundType`	"ORIGIN_CHAIN" \	"INTENTS" \	"CONFIDENTIAL_INTENTS"
`items[].[]refundReason`	string		Refund reason, null when no refund occurred
`items[].[]refundedAmountFormatted`	string		Refunded amount in readable format
`items[].[]refundedAmountUsd`	string		Refunded amount equivalent in USD
`items[].[]refundFee`	string		Refund fee in base units of the origin asset
`items[].[]refundFeeFormatted`	string		Formatted refund fee
`nextCursor`	string		Pass it back as nextCursor to poll for newer items.
`prevCursor`	string		Pass it back as prevCursor to fetch older items.

401 Unauthorized - supplied user session token is invalid or expired

{
  "message": "Unauthorized: send Authorization: Bearer <accessToken> from /v0/auth/authenticate"
}

403 History is invite-only for now

Tidepool does not return this: history is open to every authenticated account on testnet.

Community-built · not affiliated with NEAR. Tidepool is community-built and not affiliated with NEAR, Defuse or 1Click. Testnet only; test tokens have no value. Built by @realchriswilder.