{"uid":"cap_YOx9AKnXWUkULjmOl6okC","slug":"synapse-api-citrea-transaction-history-80088a75","name":"Synapse API — Citrea 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/citrea/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_jLioJtywlIA1UxkWsp99d","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 Citrea blockchain network","exampleAgentPrompt":"Pull the last 25 transactions sent from Citrea address 0xAbC...123 up through block 500000, sorted in descending order, and include full metadata for each transfer.","exampleUseCases":[{"title":"Wallet transaction audit on Citrea","prompt":"Show me all transactions sent from my Citrea wallet 0xDe...456 between block 100000 and block 200000, sorted oldest to newest, and skip any zero-value transfers."},{"title":"Monitor incoming transfers to a Citrea address","prompt":"Fetch the most recent 50 incoming transactions to Citrea address 0xFf...789 with full metadata included so I can see token details."},{"title":"Paginated history export for Citrea account","prompt":"Get the next page of transaction history for Citrea address 0xAa...111 using page key 'abc123xyz', returning up to 100 records in descending order."}],"resultDescription":"Returns a paginated list of transactions on the Citrea blockchain matching the specified filters, including sender/receiver addresses, block numbers, transfer categories, and optionally full transaction metadata. A pageKey is included when more results are available.","failureModes":["Invalid address format returns a 400 error","Unknown or future block numbers may return empty results","Invalid pageKey causes pagination to fail or restart","Unsupported category values may be silently ignored or cause a 400 error","Rate limits or payment failures return a 402 Payment Required error","Network downtime on Citrea indexer returns 503 or timeout"],"whenToPreferThis":"Use this endpoint when you need to query transaction history specifically on the Citrea Bitcoin ZK-rollup network, with support for address filtering, block range scoping, category filtering, pagination, and metadata enrichment. Prefer this over generic EVM history endpoints when Citrea-specific indexing is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:47:43.960Z","isFirstParty":false}