{"uid":"cap_HiXE5fcnWuXwkL3kDu_mi","slug":"synapse-api-zksync-transaction-history-e8cb8c27","name":"Synapse API — ZKsync Transaction History","description":"High-speed API suite for AI processing, web scraping, and smart data utilities across 57+ blockchain networks. Pay-per-call via x402.","url":"https://synapse-api-brown.vercel.app/api/zksync/tx/history","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"order":{"enum":["asc","desc"],"type":"string"},"pageKey":{"type":"string"},"toBlock":{"type":"string"},"category":{"type":"array","items":{"type":"string"}},"maxCount":{"type":"number"},"fromBlock":{"type":"string"},"toAddress":{"type":"string"},"fromAddress":{"type":"string"},"withMetadata":{"type":"boolean"},"excludeZeroValue":{"type":"boolean"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MbYVMq5A9aqkLN6nuYxv_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves paginated transaction history for addresses on the ZKsync blockchain network with filtering by block range, category, and address.","exampleAgentPrompt":"Pull the last 25 ZKsync transactions sent from wallet 0xAbC...123 to 0xDeF...456, in descending order, including token metadata and skipping zero-value transfers.","exampleUseCases":[{"title":"Wallet activity audit for compliance","prompt":"Show me all ZKsync transactions sent from 0xAbC...123 between block 5000000 and 5500000, up to 100 results, sorted newest first, with full token metadata included."},{"title":"Portfolio tracker incoming transfers","prompt":"Fetch the ZKsync transaction history for incoming transfers to my wallet 0xDeF...789, exclude any zero-value transfers, and give me the results in ascending order so I can see what arrived over time."},{"title":"DeFi protocol usage monitoring","prompt":"Get the ERC-20 transfer history on ZKsync for address 0x111...aaa, limited to 50 results per page — use pageKey xyz123 to continue from where I left off last time."}],"resultDescription":"Returns a paginated list of ZKsync transactions matching the specified filters, including transfer details such as asset type, value, sender, recipient, block number, and optionally token metadata. A pageKey is typically included to fetch the next page of results.","failureModes":["Invalid address format returns a 400 error","Invalid block range (fromBlock > toBlock) may return empty results or an error","Expired or invalid pageKey causes pagination to restart or fail","Unsupported category values may return empty results","Payment not received (402) if x402 micropayment is not included","Rate limiting or service unavailability returns 5xx errors"],"whenToPreferThis":"Use this endpoint when you need paginated ZKsync-specific transaction history with fine-grained filtering by sender, recipient, block range, and asset category. Prefer this over generic multi-chain endpoints when you specifically need ZKsync L2 transaction data with per-call pay-as-you-go pricing at $0.01 USDC.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T07:11:13.088Z","isFirstParty":false}