{"uid":"cap_xohaFyUcXggGP1DkiIRmG","slug":"tzkt-token-transfers-api-a6fad5da","name":"TzKT Token Transfers API","description":"TzKT is a comprehensive Tezos blockchain indexer API. Access blocks, operations, accounts, contracts, bigmaps, delegates, tokens and network stats through a fast REST API. No signup or API key required.","url":"https://x402.tzkt.io/v1/tokens/transfers","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"to":{"type":"string","description":"Filter by recipient address"},"from":{"type":"string","description":"Filter by sender address"},"sort":{"type":"string","description":"Sorting field and direction"},"anyof":{"type":"string","description":"Match any of the specified account fields, e.g. anyof.from.to=tz1..."},"level":{"type":"string","description":"Filter by block level (supports .eq .gt .lt)"},"limit":{"type":"integer","description":"Max items to return (1-10000)"},"amount":{"type":"string","description":"Filter by amount (supports .eq .gt .lt)"},"offset":{"type":"integer","description":"Pagination offset"},"select":{"type":"string","description":"Comma-separated list of fields to return"},"contract":{"type":"string","description":"Filter by token contract address"},"timestamp":{"type":"string","description":"Filter by timestamp (supports .eq .gt .lt)"},"token.tokenId":{"type":"string","description":"Filter by token ID"}}},"responseSchema":{"type":"array","items":{"type":"object"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Q7-0yD3Qre4UwpzXqxDDy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a paginated list of Tezos token transfer records, filterable by sender, recipient, contract, token ID, amount, block level, and timestamp.","exampleAgentPrompt":"Show me the last 50 token transfers received by tz1abc...XYZ on Tezos, filtered to transfers from contract KT1...DEF, sorted by most recent first.","exampleUseCases":[{"title":"Wallet token activity audit","prompt":"Pull up all token transfers sent or received by tz1VSUr8wwNhLAzempoch5d6hLRiTh8Cjcjb on Tezos in the last 30 days — give me up to 200 results sorted by newest first."},{"title":"NFT provenance tracking","prompt":"I need the full transfer history for token ID 42 on the Tezos contract KT1RJ6PbjHpwc3M5rw5s2Nbmefwbuwbdxton — show me every wallet that has ever held it."},{"title":"Large transfer monitoring","prompt":"Find all Tezos token transfers on contract KT1GRSvLoikgbJ571pYh1RecmQHAcFBRTV8t where the amount is greater than 1000, limit to 100 results."}],"resultDescription":"An array of token transfer objects, each containing sender address, recipient address, token contract address, token ID, transfer amount, block level, timestamp, and associated transaction hash. The response supports pagination via offset and limit parameters.","failureModes":["Invalid Tezos address format returns empty array or 400 error","Unknown contract address yields empty results","Limit exceeding 10000 returns validation error","Malformed filter syntax (e.g. bad .eq/.gt/.lt operators) returns 400","Payment failure via x402 protocol blocks request","Rate limiting or high load may cause timeouts"],"whenToPreferThis":"Use this endpoint when you need detailed, filterable Tezos token transfer history indexed by TzKT — the most comprehensive Tezos indexer. Prefer this over running your own Tezos node queries when you need fast REST access with rich filtering by sender, recipient, contract, token ID, amount range, or time window. No API key required, but a small per-call USDC micropayment applies via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:42:56.552Z","isFirstParty":false}