> For the complete documentation index, see [llms.txt](https://docs.glassnode.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.glassnode.com/basic-api/endpoints/bridges.md). # Bridges ## Bridges Deposits By Chain > \*\*Definition.\*\* The USD value deposited into bridge smart contracts on Ethereum, flowing out of the Ethereum blockchain and into target blockchains, segmented by destination chain. Bridges are protocols that enable digital assets to be transferred from one blockchain to another. When an asset is transferred out of Ethereum, it is deposited and locked into a bridge smart contract. When the asset is transferred back to Ethereum, it is withdrawn and released from the contract.\n\n\*\*Technical.\*\* Deposit Volume is computed daily by multiplying the number of tokens deposited into bridges by the latest daily price of each token. The metric only includes bridge contracts on the Ethereum side, covering bridge deposits into both L1 and L2 blockchains, providing information on the value transferred to both L1 competitors and L2 scaling solutions. Each bridge represents a single blockchain, except the ones labeled as multichain. That label is used to represent bridges that allow transferring assets across multiple different chains.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - bridges","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/bridges/deposits_by_chain":{"get":{"summary":"Bridges Deposits By Chain","description":"**Definition.** The USD value deposited into bridge smart contracts on Ethereum, flowing out of the Ethereum blockchain and into target blockchains, segmented by destination chain. Bridges are protocols that enable digital assets to be transferred from one blockchain to another. When an asset is transferred out of Ethereum, it is deposited and locked into a bridge smart contract. When the asset is transferred back to Ethereum, it is withdrawn and released from the contract.\\n\\n**Technical.** Deposit Volume is computed daily by multiplying the number of tokens deposited into bridges by the latest daily price of each token. The metric only includes bridge contracts on the Ethereum side, covering bridge deposits into both L1 and L2 blockchains, providing information on the value transferred to both L1 competitors and L2 scaling solutions. Each bridge represents a single blockchain, except the ones labeled as multichain. That label is used to represent bridges that allow transferring assets across multiple different chains.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/bridges.DepositsByChain?a=ETH)\n","operationId":"bridges.DepositsByChain","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}} ``` ## Bridges Net Flow By Chain > \*\*Definition.\*\* The net USD value flowing into or out of Ethereum bridge smart contracts, computed as bridge deposits minus bridge withdrawals. Equivalently, the net USD value moving in or out of the Ethereum blockchain via bridges.\n\n\*\*Technical.\*\* Only bridge contracts on the Ethereum side are included. Coverage spans bridge deposits into both L1 and L2 destinations, capturing value transferred to L1 competitors and to L2 scaling solutions. Each bridge represents a single destination chain, except those labeled \`multichain\`, which transfer assets across several chains. Bridges are protocols that move digital assets between blockchains: when an asset leaves Ethereum it is deposited and locked into a bridge contract, and when it returns it is withdrawn and released.\n\n\*\*Interpretation.\*\* Positive values mean more value is being deposited into bridges, i.e. a net outflow from Ethereum. Negative values mean more value is being withdrawn from bridges, i.e. a net inflow back to Ethereum.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - bridges","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/bridges/net_volume_by_chain":{"get":{"summary":"Bridges Net Flow By Chain","description":"**Definition.** The net USD value flowing into or out of Ethereum bridge smart contracts, computed as bridge deposits minus bridge withdrawals. Equivalently, the net USD value moving in or out of the Ethereum blockchain via bridges.\\n\\n**Technical.** Only bridge contracts on the Ethereum side are included. Coverage spans bridge deposits into both L1 and L2 destinations, capturing value transferred to L1 competitors and to L2 scaling solutions. Each bridge represents a single destination chain, except those labeled `multichain`, which transfer assets across several chains. Bridges are protocols that move digital assets between blockchains: when an asset leaves Ethereum it is deposited and locked into a bridge contract, and when it returns it is withdrawn and released.\\n\\n**Interpretation.** Positive values mean more value is being deposited into bridges, i.e. a net outflow from Ethereum. Negative values mean more value is being withdrawn from bridges, i.e. a net inflow back to Ethereum.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/bridges.NetVolumeByChain?a=ETH)\n","operationId":"bridges.NetVolumeByChain","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}} ``` ## Bridges TVL > \*\*Definition.\*\* The total USD value locked inside the Ethereum side of bridge smart contracts, broken out per destination blockchain. Locked tokens are unavailable on Ethereum and available on the target chain.\n\n\*\*Technical.\*\* TVL is computed daily by multiplying the number of tokens locked in each bridge smart contract by the latest daily price for each token. Bridges are protocols that transfer digital assets from one blockchain to another. When an asset leaves Ethereum, it is deposited and locked into a bridge smart contract, and when it returns to Ethereum it is withdrawn and released. This metric only includes bridge contracts on the Ethereum side, covering deposits into both L1 and L2 blockchains. Each bridge represents a single destination chain, except those labeled multichain, which fan out across multiple chains.\n\n\*\*Interpretation.\*\* A rising series means value is flowing out of Ethereum into the target chain, and a falling series means value is flowing back into Ethereum.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - bridges","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/bridges/total_value_locked_by_chain":{"get":{"summary":"Bridges TVL","description":"**Definition.** The total USD value locked inside the Ethereum side of bridge smart contracts, broken out per destination blockchain. Locked tokens are unavailable on Ethereum and available on the target chain.\\n\\n**Technical.** TVL is computed daily by multiplying the number of tokens locked in each bridge smart contract by the latest daily price for each token. Bridges are protocols that transfer digital assets from one blockchain to another. When an asset leaves Ethereum, it is deposited and locked into a bridge smart contract, and when it returns to Ethereum it is withdrawn and released. This metric only includes bridge contracts on the Ethereum side, covering deposits into both L1 and L2 blockchains. Each bridge represents a single destination chain, except those labeled multichain, which fan out across multiple chains.\\n\\n**Interpretation.** A rising series means value is flowing out of Ethereum into the target chain, and a falling series means value is flowing back into Ethereum.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/bridges.TotalValueLockedByChain?a=ETH)\n","operationId":"bridges.TotalValueLockedByChain","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}} ``` ## Bridges TVL Relative > \*\*Definition.\*\* The TVL dominance of each target-blockchain bridge, expressed as that bridge\'s TVL divided by the total TVL across all bridges.\n\n\*\*Technical.\*\* Per-bridge TVL is computed daily by multiplying the number of tokens locked in each bridge smart contract by the latest daily price for each token, then divided by the total TVL across all bridges. Bridges are protocols that transfer digital assets from one blockchain to another. When an asset leaves Ethereum, it is deposited and locked into a bridge smart contract, and when it returns to Ethereum it is withdrawn and released. This metric only includes bridge contracts on the Ethereum side, covering deposits into both L1 and L2 blockchains. Each bridge represents a single destination chain, except those labeled multichain, which fan out across multiple chains.\n\n\*\*Interpretation.\*\* A rising relative TVL means the target blockchain is gaining USD-denominated dominance inside the bridge economy, and a falling one means it is losing it.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - bridges","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/bridges/total_value_locked_by_chain_relative":{"get":{"summary":"Bridges TVL Relative","description":"**Definition.** The TVL dominance of each target-blockchain bridge, expressed as that bridge's TVL divided by the total TVL across all bridges.\\n\\n**Technical.** Per-bridge TVL is computed daily by multiplying the number of tokens locked in each bridge smart contract by the latest daily price for each token, then divided by the total TVL across all bridges. Bridges are protocols that transfer digital assets from one blockchain to another. When an asset leaves Ethereum, it is deposited and locked into a bridge smart contract, and when it returns to Ethereum it is withdrawn and released. This metric only includes bridge contracts on the Ethereum side, covering deposits into both L1 and L2 blockchains. Each bridge represents a single destination chain, except those labeled multichain, which fan out across multiple chains.\\n\\n**Interpretation.** A rising relative TVL means the target blockchain is gaining USD-denominated dominance inside the bridge economy, and a falling one means it is losing it.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/bridges.TotalValueLockedByChainRelative?a=ETH)\n","operationId":"bridges.TotalValueLockedByChainRelative","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}} ``` ## Bridges Withdrawals By Chain > \*\*Definition.\*\* The total USD value withdrawn from bridge smart contracts on Ethereum and therefore flowing back into Ethereum and out of the target blockchains, broken out per destination chain.\n\n\*\*Technical.\*\* Withdrawal volume is computed daily by multiplying the number of tokens withdrawn from bridges by the latest daily price of each token. Bridges are protocols that transfer digital assets from one blockchain to another. When an asset leaves Ethereum, it is deposited and locked into a bridge smart contract, and when it returns to Ethereum it is withdrawn and released. This metric only includes bridge contracts on the Ethereum side, covering deposits into both L1 and L2 blockchains. Each bridge represents a single destination chain, except those labeled multichain, which fan out across multiple chains.\n\ > \ > \[View in Studio]\()
```json {"openapi":"3.0.3","info":{"title":"Glassnode API - bridges","version":"1.0.0"},"servers":[{"url":"https://api.glassnode.com","description":"Production API server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"query","name":"api_key","description":"Your Glassnode API key"}},"schemas":{"TimeSeriesResponse":{"type":"array","items":{"$ref":"#/components/schemas/TimeSeriesDataPoint"}},"TimeSeriesDataPoint":{"type":"object","properties":{"t":{"type":"integer","format":"int64","description":"Unix timestamp"},"v":{"oneOf":[{"type":"number"},{"type":"object"},{"type":"array"}],"description":"Metric value (can be number, object, or array depending on the metric)"},"o":{"type":"object","description":"Object containing multiple metric values (when applicable)","additionalProperties":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/metrics/bridges/withdrawals_by_chain":{"get":{"summary":"Bridges Withdrawals By Chain","description":"**Definition.** The total USD value withdrawn from bridge smart contracts on Ethereum and therefore flowing back into Ethereum and out of the target blockchains, broken out per destination chain.\\n\\n**Technical.** Withdrawal volume is computed daily by multiplying the number of tokens withdrawn from bridges by the latest daily price of each token. Bridges are protocols that transfer digital assets from one blockchain to another. When an asset leaves Ethereum, it is deposited and locked into a bridge smart contract, and when it returns to Ethereum it is withdrawn and released. This metric only includes bridge contracts on the Ethereum side, covering deposits into both L1 and L2 blockchains. Each bridge represents a single destination chain, except those labeled multichain, which fan out across multiple chains.\\n\n\n[View in Studio](https://studio.glassnode.com/charts/bridges.WithdrawalsByChain?a=ETH)\n","operationId":"bridges.WithdrawalsByChain","parameters":[{"name":"a","in":"query","required":true,"description":"asset id - (see metadata (metadata/metric) page for more details)}","schema":{"type":"string"},"style":"form","explode":false},{"name":"s","in":"query","required":false,"description":"since, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"u","in":"query","required":false,"description":"until, unix timestamp","schema":{"type":"integer"},"style":"form","explode":false},{"name":"i","in":"query","required":false,"description":"frequency interval - 24h","schema":{"type":"string"},"style":"form","explode":false},{"name":"f","in":"query","required":false,"description":"format - csv, json","schema":{"type":"string","enum":["csv","json"],"default":"json"},"style":"form","explode":false},{"name":"timestamp_format","in":"query","required":false,"description":"timestamp format - unix or humanized (RFC 3339)","schema":{"type":"string","enum":["unix","humanized"],"default":"unix"},"style":"form","explode":false}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimeSeriesResponse"}}}},"400":{"description":"Bad Request - Invalid parameters or unsupported asset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}} ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.glassnode.com/basic-api/endpoints/bridges.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.