{"uid":"cap_5KMSl0oSDOaHqvedi4of-","slug":"tzkt-contracts-list-api-d4558bfc","name":"TzKT Contracts List 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/contracts","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"kind":{"enum":["smart_contract","delegator_contract"],"type":"string","description":"Contract kind filter"},"sort":{"type":"string","description":"Sorting field and direction"},"limit":{"type":"integer","description":"Max items to return (1-10000)"},"offset":{"type":"integer","description":"Pagination offset"},"select":{"type":"string","description":"Comma-separated list of fields to return"},"balance":{"type":"string","description":"Filter by balance in mutez (supports .eq .gt .lt)"}}},"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_qUFBOtNbworCQKTwN4FdT","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 filtered, paginated list of Tezos smart contracts from the TzKT blockchain indexer","exampleAgentPrompt":"Show me the top 50 Tezos smart contracts sorted by balance descending, only return the address and balance fields, and filter to contracts with a balance greater than 1000000 mutez.","exampleUseCases":[{"title":"Discover high-value DeFi contracts","prompt":"Find me the top 20 Tezos smart contracts with the highest balances — I want to see their addresses and current holdings to identify the biggest DeFi protocols on-chain."},{"title":"Audit FA2 token contracts","prompt":"List all FA2 token contracts on Tezos, up to 100 results, sorted by balance — I'm building a report on active token issuers and need their contract addresses."},{"title":"Monitor contract landscape changes","prompt":"Give me a snapshot of up to 500 Tezos contracts sorted by their creation order, paginated from offset 0, so I can track new smart contract deployments on the network."}],"resultDescription":"Returns a JSON array of Tezos smart contract objects. Each object includes contract address, kind (e.g. delegator, smart_contract), balance in mutez, and other on-chain metadata depending on the 'select' fields specified. Results are paginated and sorted per request parameters.","failureModes":["Invalid 'kind' enum value returns empty results or 400 error","Limit exceeding 10000 returns a validation error","Malformed balance filter syntax (missing operator suffix) returns 400","Network congestion may increase response latency","Requesting too many fields via 'select' may cause partial data return"],"whenToPreferThis":"Use this endpoint when you need to enumerate, filter, or paginate through Tezos smart contracts at the network level without requiring authentication. It is ideal for blockchain analytics, DeFi research, contract discovery, and on-chain auditing tasks. Prefer this over individual contract lookup endpoints when you need a list view rather than details about a single known contract address.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:50:37.096Z","isFirstParty":false}