{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":["admonition","cards","card"]},"type":"markdown"},"seo":{"title":"What is Vilna - Blockchain API Platform","projectTitle":"Vilna Docs","description":"Unified REST API for blockchain monitoring, HD wallet management, and payment tracking. One API for Bitcoin, Ethereum, Solana, TRON, and more.","siteUrl":"https://docs.vilna.io","keywords":["crypto asset management","blockchain monitoring","digital asset security","cryptocurrency API","wallet tracking","blockchain analytics","enterprise crypto","real-time blockchain","CAIP-19","BIP44"],"lang":"en-US","image":"https://cdn.vilna.io/docs/previews/overview.png","meta":[{"name":"og:type","content":"website"},{"name":"og:site_name","content":"Vilna Documentation"},{"name":"og:image:width","content":"1200"},{"name":"og:image:height","content":"630"},{"name":"twitter:card","content":"summary_large_image"}],"llmstxt":{"title":"Vilna API Documentation","description":"Vilna is a blockchain monitoring and wallet management platform. It provides a single unified REST API for tracking addresses, transactions, balances, and activity across top blockchains - Bitcoin, Ethereum, Solana, TRON, TON, Cosmos, and others. The API uses CAIP-2/CAIP-19 standards for cross-chain identification, HD wallet management (BIP-32/44) for address derivation, and RFC 7807 for error responses. Authentication is via API key in the X-Api-Key header.\n","excludeFiles":["legal/**/*.md","@l10n/**/*.md"],"sections":[{"title":"Overview","description":"What Vilna is, supported blockchains, and target audience","includeFiles":["overview.md"],"excludeFiles":[]},{"title":"Getting Started","description":"Quickstart guide and core API concepts","includeFiles":["guides/quickstart.md","guides/dashboard.md","guides/core-concepts.md","guides/authentication.md"],"excludeFiles":[]},{"title":"API Reference","description":"Platform API and Management API endpoint documentation","includeFiles":["apis/platform/index.md","apis/mgmt/index.md","apis/rpc/index.md","apis/platform/api.yaml","apis/mgmt/api.yaml"],"excludeFiles":[]},{"title":"Developer Guides","description":"Integration patterns, events, notifications, SDK, and error handling","includeFiles":["guides/events.md","guides/channels.md","guides/integration-patterns.md","guides/sdk.md","guides/mcp.md","guides/errors.md","guides/simulation.md","guides/invoices.md"],"excludeFiles":[]},{"title":"Business","description":"Value proposition, use cases, and onboarding","includeFiles":["business/index.md","business/use-cases.md"],"excludeFiles":[]},{"title":"Optional","description":"Additional reference material","includeFiles":["guides/blockchain-basics.md","guides/faq.md","apis/mgmt/guide.md","guides/widget.md","guides/storage-client.md","apis/platform/caip-standards.md","apis/mgmt/authorization.md"],"excludeFiles":[]}],"hide":false},"priority":0.9,"jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://docs.vilna.io/"},{"@type":"ListItem","position":2,"name":"Overview"}]},{"@type":"SoftwareApplication","name":"Vilna API","description":"Blockchain monitoring and wallet management platform providing a single unified REST API for top blockchains.","url":"https://vilna.io","applicationCategory":"FinanceApplication","operatingSystem":"Web","softwareVersion":"1.0.0-beta.2","releaseNotes":"https://docs.vilna.io/changelog","featureList":"Multi-chain monitoring, HD wallet management, Transaction simulation, Webhook notifications, CAIP standards","offers":{"@type":"Offer","price":"0","priceCurrency":"USD"},"author":{"@type":"Organization","name":"Vilna","url":"https://vilna.io"}}]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"what-is-vilna","__idx":0},"children":["What is Vilna"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Vilna is a blockchain API platform that gives your applications a single REST interface for monitoring addresses, wallets, and payments. Instead of integrating each chain separately, you connect once and get normalized, consistent data from Bitcoin, Ethereum, Solana, TRON, and every other supported network."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API indexes and processes blockchain data before it reaches your application. Confirmations, chain reorganizations, and network-specific edge cases are resolved on Vilna's side. Your code works with clean, predictable responses regardless of the underlying chain."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-it-works","__idx":1},"children":["How it works"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your application makes standard REST calls with an API key. Vilna handles the chain-specific complexity behind a single consistent interface. Every chain is identified by ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/platform/caip-standards"},"children":["CAIP-2"]},", every asset by ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/platform/caip-standards"},"children":["CAIP-19"]}," - no proprietary naming schemes."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When something happens on-chain - a deposit, a confirmation, a payment - Vilna delivers the event to your webhook endpoint or Telegram channel with at-least-once delivery guarantees."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"key-capabilities","__idx":2},"children":["Key capabilities"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"multi-chain-monitoring","__idx":3},"children":["Multi-chain monitoring"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Track addresses and transactions across all supported chains through a single API. Register an address, and Vilna monitors it for activity - incoming transfers, outgoing transactions, token movements, and confirmation status changes. Results come back in the same format whether the address is on Ethereum, Bitcoin, or Solana."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"hd-wallet-management","__idx":4},"children":["HD wallet management"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Import extended public keys (xPub, BIP-32/44/49/84) and derive deposit addresses through the API. Vilna handles the derivation math - your application gets unique addresses for each customer without managing key material or cryptographic libraries. Private keys never leave your infrastructure."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"payment-tracking-and-invoicing","__idx":5},"children":["Payment tracking and invoicing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create payment invoices on addresses you control, whether you provide them directly or derive them from your xPub. Vilna monitors incoming transactions, tracks confirmation progress, and handles partial payments and overpayments automatically. Customers see a payment page with a QR code and live status updates."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"transaction-simulation","__idx":6},"children":["Transaction simulation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Preview EVM transactions before broadcasting. Vilna simulates the execution and returns the expected outcome - balance changes, gas consumption, token transfers, and potential reverts. Catch errors before they cost real money."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"event-delivery","__idx":7},"children":["Event delivery"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Receive real-time notifications through webhooks or Telegram when blockchain activity occurs. Events cover deposits, withdrawals, confirmations, and balance changes. Every event is delivered with at-least-once delivery guarantees."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Standards-based by design"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every chain is identified by ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-2.md"},"children":["CAIP-2"]},", every asset by ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-19.md"},"children":["CAIP-19"]},", every error follows ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.rfc-editor.org/rfc/rfc7807"},"children":["RFC 7807"]},". No proprietary formats to learn."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"supported-blockchains","__idx":8},"children":["Supported blockchains"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Family"},"children":["Family"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Networks"},"children":["Networks"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["EVM"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ethereum, BSC, Polygon, Avalanche, Arbitrum, Optimism, Base, zkSync Era, Linea, Moonbeam, Cronos, Fantom"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Bitcoin-like"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Bitcoin, Litecoin, Bitcoin Cash, Dogecoin, Dash, Zcash"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Other L1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Solana, TRON, TON, Cosmos, Cardano, Near, Tezos, Algorand, Flow, Harmony, Sui, Aptos, Monero"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["New networks are added regularly. Call ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/platform/api/blockchain/list-blockchains"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /blockchains"]}]}," in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/platform/"},"children":["Platform API"]}," for the current list."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api-services","__idx":9},"children":["API services"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Vilna exposes three services:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/platform/"},"children":["Platform API"]}]}," - blockchain operations: addresses, transactions, balances, wallets, events, invoices, and simulation. This is the API your product integrates with."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/rpc"},"children":["RPC"]}]}," - direct access to blockchain nodes via JSON-RPC and gRPC. One endpoint and one API key for all supported chains, without running your own nodes."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/mgmt/"},"children":["Management API"]}]}," - administration: workspaces, projects, team members, and API key lifecycle. This is the API your operations team uses to manage access and organize resources."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All three use the same authentication model and the same API key infrastructure."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"who-vilna-is-built-for","__idx":10},"children":["Who Vilna is built for"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Crypto exchanges"]}," - deposit detection, address derivation, and balance monitoring across dozens of chains."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payment platforms"]}," - invoice address monitoring with QR codes, partial payment tracking, and automatic confirmation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Wallet providers"]}," - HD wallet derivation, real-time balance monitoring, and multi-chain portfolio tracking."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["DeFi protocols"]}," - programmatic access to on-chain data for automated strategies."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Corporate treasury"]}," - multi-chain wallet monitoring, movement alerts, and transaction simulation."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"developer-experience","__idx":11},"children":["Developer experience"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Vilna is designed to minimize integration time:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/quickstart"},"children":["Quickstart"]}]}," - first API call in 10 minutes."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/sdk"},"children":["TypeScript SDK"]}]}," - fully typed client generated from the OpenAPI spec."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/mcp"},"children":["MCP server"]}]}," - connect your AI coding assistant (Claude, Cursor, VS Code) to the live API reference for faster integration."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/platform/api"},"children":["OpenAPI spec"]}]}," - generate clients in any language."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"where-to-go-next","__idx":12},"children":["Where to go next"]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":2,"cardMinWidth":240},"children":[{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Quickstart","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/guides/quickstart"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Make your first API call in 10 minutes"]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Vilna for Business","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/business"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Value proposition, use cases, and onboarding process"]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Core Concepts","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/guides/core-concepts"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Understand addresses, wallets, events, and API patterns"]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Platform API","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/apis/platform/"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Full endpoint reference for blockchain monitoring"]}]}]}]},"headings":[{"value":"What is Vilna","id":"what-is-vilna","depth":1},{"value":"How it works","id":"how-it-works","depth":2},{"value":"Key capabilities","id":"key-capabilities","depth":2},{"value":"Multi-chain monitoring","id":"multi-chain-monitoring","depth":3},{"value":"HD wallet management","id":"hd-wallet-management","depth":3},{"value":"Payment tracking and invoicing","id":"payment-tracking-and-invoicing","depth":3},{"value":"Transaction simulation","id":"transaction-simulation","depth":3},{"value":"Event delivery","id":"event-delivery","depth":3},{"value":"Supported blockchains","id":"supported-blockchains","depth":2},{"value":"API services","id":"api-services","depth":2},{"value":"Who Vilna is built for","id":"who-vilna-is-built-for","depth":2},{"value":"Developer experience","id":"developer-experience","depth":2},{"value":"Where to go next","id":"where-to-go-next","depth":2}],"frontmatter":{"seo":{"title":"What is Vilna - Blockchain API Platform","description":"Unified REST API for blockchain monitoring, HD wallet management, and payment tracking. One API for Bitcoin, Ethereum, Solana, TRON, and more.","priority":0.9,"image":"https://cdn.vilna.io/docs/previews/overview.png","jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://docs.vilna.io/"},{"@type":"ListItem","position":2,"name":"Overview"}]},{"@type":"SoftwareApplication","name":"Vilna API","description":"Blockchain monitoring and wallet management platform providing a single unified REST API for top blockchains.","url":"https://vilna.io","applicationCategory":"FinanceApplication","operatingSystem":"Web","softwareVersion":"1.0.0-beta.2","releaseNotes":"https://docs.vilna.io/changelog","featureList":"Multi-chain monitoring, HD wallet management, Transaction simulation, Webhook notifications, CAIP standards","offers":{"@type":"Offer","price":"0","priceCurrency":"USD"},"author":{"@type":"Organization","name":"Vilna","url":"https://vilna.io"}}]}}},"lastModified":"2026-05-26T20:25:55.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}