Transaction history

​

Prerequisites

• The queried address must belong to a Turnkey wallet account. Standalone private-key addresses are not supported.
• Pass the network as a CAIP-2 identifier (caip2). For Solana, human-readable aliases such as solana:mainnet and solana:devnet are accepted and normalized to canonical CAIP-2 values by the API.

​

History coverage

1. The network start date in the table below, and
2. When the wallet account was added to Turnkey — either when it was created in a Turnkey wallet or when an existing address was imported.

​

EVM transaction history

• transactionHash, block (number, hash, RFC 3339 timestamp), and status (CONFIRMED or FINALIZED)
• from, optional to, and origin (for example TURNKEY for Turnkey-submitted transactions)
• fee with atomic amount and caip19 asset identifier
• transfers[] with direction (IN / OUT relative to the queried address), asset, atomic amount, counterparty, and optional display strings for UI
• Optional turnkey metadata when Turnkey submitted the transaction: sponsored, activityFingerprint, and submittedAt

​

Solana transaction history

• signature instead of transactionHash
• feePayer — the account that paid the transaction fee (first signer in the message)
• signers[] — each signer’s address and whether the account was writable in the message

​

Pagination

• hasNextPage / hasPreviousPage indicate whether more results exist in either direction.
• Pass pageInfo.endCursor as the next request’s paginationOptions.after to fetch older transactions (continue paging down the newest-first list).
• Pass pageInfo.startCursor as paginationOptions.before to fetch newer transactions.
• Cursors are opaque and valid only for the same address and caip2 query. Do not construct or modify them.

import { Turnkey } from "@turnkey/sdk-server";

const client = new Turnkey({
  apiBaseUrl: "https://api.turnkey.com",
  apiPublicKey: process.env.API_PUBLIC_KEY!,
  apiPrivateKey: process.env.API_PRIVATE_KEY!,
  defaultOrganizationId: process.env.ORGANIZATION_ID!,
}).apiClient();

let after: string | undefined;

for (;;) {
  const { transactions, pageInfo } =
    await client.listEthTransactionHistory({
      organizationId: process.env.ORGANIZATION_ID!,
      address: "<wallet-account-address>",
      caip2: "eip155:1",
      paginationOptions: {
        limit: "25",
        ...(after ? { after } : {}),
      },
    });

  if (!transactions.length) break;

  // process transactions...

  if (!pageInfo?.hasNextPage || !pageInfo.endCursor) break;
  after = pageInfo.endCursor;
}

​

SDK example

​

Next steps

• List Eth transaction history and List Sol transaction history in the API reference
• Balances for current asset balances on supported chains
• Broadcasting transactions for submitting new transactions through Turnkey