{"uid":"cap_5GhiFrknz8OtQsSPFun0u","slug":"synapse-api-optimism-token-transfers-57c5d4bc","name":"Synapse API — Optimism Token Transfers","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/optimism/token/transfers","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"order":{"enum":["asc","desc"],"type":"string"},"owner":{"type":"string"},"pageKey":{"type":"string"},"toBlock":{"type":"string"},"maxCount":{"type":"number"},"fromBlock":{"type":"string"},"contractAddresses":{"type":"array","items":{"type":"string"}}}},"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_koexucCPIBj3vtlIudu43","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 ERC-20 and native token transfer history for a given address on the Optimism blockchain network, with filtering by block range and contract address.","exampleAgentPrompt":"Pull all token transfers for the Optimism wallet 0xAbC...123, sorted descending, covering blocks 110000000 to 115000000, and limit results to 100 entries — include transfers for the USDC contract at 0x7F5c764cBc14f9669B88837ca1490cCa17c31607.","exampleUseCases":[{"title":"Audit DeFi wallet token activity","prompt":"Show me all token transfers in and out of the Optimism wallet 0xAbC...123 from block 100000000 to 115000000, sorted newest first, up to 200 results."},{"title":"Track USDC flows on Optimism","prompt":"Get me all USDC transfers for address 0xDef...456 on Optimism, only for the USDC contract 0x7F5c764cBc14f9669B88837ca1490cCa17c31607, ascending by block, last 50 records."},{"title":"Paginate through large transfer history","prompt":"I need the next page of token transfer results on Optimism for wallet 0x111...222 — use page key abc123xyz and give me up to 100 transfers descending."}],"resultDescription":"Returns a paginated list of token transfer events on the Optimism network for the specified wallet, including sender, recipient, token contract, amount, block number, and transaction hash. A pageKey is provided when more results are available.","failureModes":["Invalid or malformed owner address returns an error or empty result","Unknown contractAddress silently returns no results","Invalid block number format causes a 400 error","pageKey expiration or invalidity causes a pagination error","Rate limiting or payment failure returns 402 or 429","Very wide block ranges may time out or return truncated results"],"whenToPreferThis":"Use this endpoint when you need token transfer history specifically on the Optimism L2 network. It is ideal for wallet auditing, portfolio tracking, DeFi analytics, or compliance checks scoped to Optimism. Prefer this over Ethereum mainnet endpoints when the user's wallet activity is on Optimism (OP chain). Supports pagination for large datasets via pageKey.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:47:03.995Z","isFirstParty":false}