{"uid":"cap_ecq5a1ixnGYuTJf6V64r1","slug":"synapse-api-celo-token-transfers-5fdae0e9","name":"Synapse API — Celo 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/celo/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_evX1ieU-ywzGcxlmuI7-L","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 token transfer history for a given owner address on the Celo blockchain, with filtering by block range, contract address, and pagination support.","exampleAgentPrompt":"Pull all token transfers for Celo address 0x1234...abcd from block 18000000 to 18500000, sorted descending, and return up to 100 results — include only transfers involving the cUSD contract 0x765de816845861e75a25fca122bb6898b8b1282a.","exampleUseCases":[{"title":"Audit wallet token activity","prompt":"Show me all token transfers in and out of my Celo wallet 0xAbCd...1234 from block 20000000 to the latest block, sorted newest first, up to 50 results."},{"title":"Track specific token movements","prompt":"Find all cEUR token transfers for address 0xDEAD...BEEF on Celo — use contract address 0xd8763cba276a3738e6de85b4b3bf5fded6d6ca73 and give me the 200 most recent ones in descending order."},{"title":"Paginate through large transfer history","prompt":"I need to page through all token transfers for Celo address 0x9999...AAAA — start from pageKey 'abc123xyz' and return the next 100 results in ascending block order."}],"resultDescription":"A list of token transfer events for the specified Celo address, each containing transaction hash, block number, from/to addresses, token contract address, token amount, and asset metadata. Also returns a pagination key for fetching subsequent pages when results are truncated.","failureModes":["Invalid owner address format returns an error or empty result","Invalid block range (fromBlock > toBlock) may return an error","Unknown or malformed contractAddresses silently return no matching transfers","Missing required owner field causes a 400 bad request","Rate limiting or payment failure results in 402 or 429 response","Very wide block ranges may time out or return partial results"],"whenToPreferThis":"Use this endpoint when you need historical token transfer data specifically on the Celo blockchain, especially when you need filtering by block range or contract address. Prefer this over general Ethereum endpoints when the target address is on Celo. Best for auditing wallet activity, building transaction history views, or detecting specific token movements on Celo.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:51:47.991Z","isFirstParty":false}