{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-apis/platform/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["cards","card"]},"type":"markdown"},"seo":{"title":"CAIP Standards - Cross-Chain Identification","projectTitle":"Vilna Docs","description":"How Vilna uses Chain Agnostic Improvement Proposals for consistent cross-chain identification of blockchains, accounts, and assets.","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/platform-api.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.5,"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":"Platform API","item":"https://docs.vilna.io/apis/platform"},{"@type":"ListItem","position":3,"name":"CAIP Standards"}]}]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"caip-standards","__idx":0},"children":["CAIP standards"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Vilna API implements Chain Agnostic Improvement Proposals (CAIP) for consistent cross-chain identification. These standards provide a universal way to identify blockchains, accounts, and assets across different blockchain ecosystems. To see how CAIP identifiers are used in practice across API requests and responses, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/core-concepts"},"children":["Core Concepts"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"caip-2-blockchain-identification","__idx":2},"children":["CAIP-2: Blockchain identification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Provides a way to identify any blockchain in a human-readable, developer-friendly format."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"format","__idx":3},"children":["Format"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"<namespace>:<reference>\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"components","__idx":4},"children":["Components"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["namespace"]},": Identifies the blockchain namespace (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eip155"]}," for EVM chains, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bip122"]}," for Bitcoin)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["reference"]},": Chain-specific identifier (chain ID for EVM, genesis block hash for Bitcoin)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"examples","__idx":5},"children":["Examples"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"evm-chains","__idx":6},"children":["EVM chains"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eip155:1"]}," - Ethereum Mainnet"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eip155:56"]}," - BNB Smart Chain (BSC)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eip155:137"]}," - Polygon"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eip155:43114"]}," - Avalanche C-Chain"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eip155:42161"]}," - Arbitrum One"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eip155:10"]}," - Optimism"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"non-evm-chains","__idx":7},"children":["Non-EVM chains"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bip122:000000000019d6689c085ae165831e93"]}," - Bitcoin Mainnet"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bip122:00000000001a91e3dace36e2be3bf030"]}," - Dogecoin"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cosmos:cosmoshub-4"]}," - Cosmos Hub"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]}," - Solana Mainnet"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"caip-10-account-identification","__idx":8},"children":["CAIP-10: Account identification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Identifies blockchain accounts across different chains with a unified format."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"format-1","__idx":9},"children":["Format"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"<blockchain_gid>:<account_address>\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"components-1","__idx":10},"children":["Components"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["blockchain_gid"]},": CAIP-2 blockchain identifier"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["account_address"]},": Chain-specific address format"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"examples-1","__idx":11},"children":["Examples"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"ethereum-accounts","__idx":12},"children":["Ethereum accounts"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"eip155:1:0x742d35Cc6634C0532925a3b844Bc9e7595f7B123\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"bitcoin-accounts","__idx":13},"children":["Bitcoin accounts"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"bip122:000000000019d6689c085ae165831e93:1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"solana-accounts","__idx":14},"children":["Solana accounts"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp:9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"caip-19-asset-identification","__idx":15},"children":["CAIP-19: Asset identification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Provides a universal way to identify any digital asset on any blockchain."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"format-2","__idx":16},"children":["Format"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"<blockchain_gid>/<asset_namespace>:<asset_reference>\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"components-2","__idx":17},"children":["Components"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["blockchain_gid"]},": CAIP-2 blockchain identifier"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["asset_namespace"]},": Type of asset (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["slip44"]}," for native, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["erc20"]},"/",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["erc721"]}," for tokens)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["asset_reference"]},": Asset-specific identifier"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"asset-types","__idx":18},"children":["Asset types"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"native-currencies","__idx":19},"children":["Native currencies"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["slip44"]}," namespace with the coin type from SLIP-44 registry:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"<blockchain_gid>/slip44:<coin_type>\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Examples:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eip155:1/slip44:60"]}," - ETH on Ethereum"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eip155:56/slip44:60"]}," - BNB on BSC"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eip155:137/slip44:60"]}," - MATIC on Polygon"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bip122:000000000019d6689c085ae165831e93/slip44:0"]}," - BTC on Bitcoin"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"erc-20-tokens","__idx":20},"children":["ERC-20 tokens"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["erc20"]}," namespace with the contract address:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"<blockchain_gid>/erc20:<contract_address>\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Examples:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eip155:1/erc20:0xdAC17F958D2ee523a2206206994597C13D831ec7"]}," - USDT on Ethereum"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eip155:1/erc20:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"]}," - USDC on Ethereum"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eip155:56/erc20:0x55d398326f99059fF775485246999027B3197955"]}," - USDT on BSC"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"nfts-erc-721","__idx":21},"children":["NFTs (ERC-721)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["erc721"]}," namespace with the contract address and token ID:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"<blockchain_gid>/erc721:<contract_address>/<token_id>\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eip155:1/erc721:0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D/101"]}," - BAYC #101"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"references","__idx":22},"children":["References"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/ChainAgnostic/CAIPs/blob/master/CAIPs/caip-2.md"},"children":["CAIP-2 Specification"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/ChainAgnostic/CAIPs/blob/master/CAIPs/caip-10.md"},"children":["CAIP-10 Specification"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/ChainAgnostic/CAIPs/blob/master/CAIPs/caip-19.md"},"children":["CAIP-19 Specification"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/satoshilabs/slips/blob/master/slip-0044.md"},"children":["SLIP-44 Registry"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"further-reading","__idx":23},"children":["Further reading"]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":2,"cardMinWidth":240},"children":[{"$$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":["How CAIP identifiers are used across the Vilna API"]}]},{"$$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":["Complete endpoint documentation with CAIP examples"]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Blockchain Basics","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/guides/blockchain-basics"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Addresses, keys, and chain families explained"]}]}]}]},"headings":[{"value":"CAIP standards","id":"caip-standards","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"CAIP-2: Blockchain identification","id":"caip-2-blockchain-identification","depth":2},{"value":"Format","id":"format","depth":3},{"value":"Components","id":"components","depth":3},{"value":"Examples","id":"examples","depth":3},{"value":"EVM chains","id":"evm-chains","depth":4},{"value":"Non-EVM chains","id":"non-evm-chains","depth":4},{"value":"CAIP-10: Account identification","id":"caip-10-account-identification","depth":2},{"value":"Format","id":"format-1","depth":3},{"value":"Components","id":"components-1","depth":3},{"value":"Examples","id":"examples-1","depth":3},{"value":"Ethereum accounts","id":"ethereum-accounts","depth":4},{"value":"Bitcoin accounts","id":"bitcoin-accounts","depth":4},{"value":"Solana accounts","id":"solana-accounts","depth":4},{"value":"CAIP-19: Asset identification","id":"caip-19-asset-identification","depth":2},{"value":"Format","id":"format-2","depth":3},{"value":"Components","id":"components-2","depth":3},{"value":"Asset types","id":"asset-types","depth":3},{"value":"Native currencies","id":"native-currencies","depth":4},{"value":"ERC-20 tokens","id":"erc-20-tokens","depth":4},{"value":"NFTs (ERC-721)","id":"nfts-erc-721","depth":4},{"value":"References","id":"references","depth":2},{"value":"Further reading","id":"further-reading","depth":2}],"frontmatter":{"seo":{"title":"CAIP Standards - Cross-Chain Identification","description":"How Vilna uses Chain Agnostic Improvement Proposals for consistent cross-chain identification of blockchains, accounts, and assets.","priority":0.5,"image":"https://cdn.vilna.io/docs/previews/platform-api.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":"Platform API","item":"https://docs.vilna.io/apis/platform"},{"@type":"ListItem","position":3,"name":"CAIP Standards"}]}]}}},"lastModified":"2026-03-25T01:54:58.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/platform/caip-standards","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}