---
updatedAt: 2025-05-22T20:28:10.000Z
agentTools:
  projectIndex: https://docs.klarda.com/llms.txt
---

# Get Protocol TVL by Chain ID

Get Wallet Transfer Transaction

## Definition

This endpoint retrieves Total Value Locked (TVL) data for protocols on a specific blockchain network identified by its chain\_id. TVL represents the total amount of assets, typically cryptocurrency tokens, locked or held within various protocols' smart contracts on the specified blockchain network.

## Query Parameters

* **chain\_id** (int): The identifier of the blockchain network for which TVL data of protocols is requested.

## Response

The response will include a JSON object or array containing TVL data for protocols on the specified blockchain network.

> This endpoint is useful for monitoring and analyzing the liquidity and total value of assets locked within protocols operating on specific blockchain networks, providing insights into the decentralized finance (DeFi) ecosystem's usage and growth.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "klarda-protocol-api",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.klarda.com/api/v1/protocol"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "query",
        "name": "api_key"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/marketcap/tvl/chain": {
      "get": {
        "summary": "Get Protocol TVL by Chain ID",
        "description": "Get Wallet Transfer Transaction",
        "operationId": "get-protocol-tvl-by-chain",
        "parameters": [
          {
            "name": "chain_id",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"success\": true,\n  \"data\": {\n    \"chain_id\": 1,\n    \"stored_time\": \"2024-04-25T00:00:00.000Z\",\n    \"amount_in_usd\": 53717960604.59807,\n    \"chain_name\": \"Ethereum\",\n    \"id\": \"6629dd75541bd8965cf02bc1\"\n  }\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true,
                      "default": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "chain_id": {
                          "type": "integer",
                          "example": 1,
                          "default": 0
                        },
                        "stored_time": {
                          "type": "string",
                          "example": "2024-04-25T00:00:00.000Z"
                        },
                        "amount_in_usd": {
                          "type": "number",
                          "example": 53717960604.59807,
                          "default": 0
                        },
                        "chain_name": {
                          "type": "string",
                          "example": "Ethereum"
                        },
                        "id": {
                          "type": "string",
                          "example": "6629dd75541bd8965cf02bc1"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"statusCode\": 400,\n  \"message\": \"Wrong api_key, please check!\",\n  \"error\": \"Bad Request\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 400,
                      "default": 0
                    },
                    "message": {
                      "type": "string",
                      "example": "Wrong api_key, please check!"
                    },
                    "error": {
                      "type": "string",
                      "example": "Bad Request"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "401",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"statusCode\": 401,\n  \"message\": \"Unauthorized\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 401,
                      "default": 0
                    },
                    "message": {
                      "type": "string",
                      "example": "Unauthorized"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "500",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"statusCode\": 500,\n  \"message\": \"Internal server error\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 500,
                      "default": 0
                    },
                    "message": {
                      "type": "string",
                      "example": "Internal server error"
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```