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

# Get Token Amount

Get NFT Metadata By Address

## Definition

This endpoint retrieves the amount of a specified token available on a particular exchange. It provides users with real-time information about the liquidity or availability of the token on the exchange, facilitating trading decisions and market analysis.

## Query Parameters

* **exchange\_key** (string): The unique identifier or key representing the exchange from which token amount is requested.
* **chain\_id** (string): The identifier of the blockchain network. Use "all" to indicate all available chains.
* **token\_id** (string): The unique identifier or symbol of the token for which the amount is requested.

## Response

The response will include a JSON object containing the amount of the specified token available on the exchange.

> This endpoint is essential for obtaining real-time liquidity information of a specific token on a particular exchange, enabling users to assess market depth and availability for trading purposes.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "klarda-token-market-api",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.klarda.com/api/v1/market"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "query",
        "name": "api_key"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/exchange/token-amount": {
      "get": {
        "summary": "Get Token Amount",
        "description": "Get NFT Metadata By Address",
        "operationId": "get-exchange-token-amount",
        "parameters": [
          {
            "name": "exchange_key",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "chain_id",
            "in": "query",
            "description": "String - denotes the specific blockchain network from which the data has been crawled. Available values: mantle, fuse, optimism, avalanche, ethereumpow, base, oasisemerald, milkomedacardano, velas, kcc, cronos, pulechain, stepnetwork, dogechain, moonriver, moonbeam, arbitrum, fantom, bsc, iotex, harmony, ethereum, polygon. Default to \"all\"",
            "required": true,
            "schema": {
              "type": "string",
              "default": "all"
            }
          },
          {
            "name": "token_id",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"success\": true,\n  \"data\": {\n    \"total\": 339,\n    \"result\": [\n      {\n        \"baseToken\": {\n          \"address\": \"0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82\",\n          \"name\": \"PancakeSwap Token\",\n          \"symbol\": \"Cake\",\n          \"logo_uri\": \"https://dbqxolzl7v371.cloudfront.net/150x150.pancakeswap1614939043529.png\"\n        },\n        \"quoteToken\": {\n          \"address\": \"0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c\",\n          \"name\": \"Wrapped BNB\",\n          \"symbol\": \"WBNB\"\n        },\n        \"priceUsd\": 3.011,\n        \"volume\": {\n          \"h24\": 1397761.78,\n          \"h6\": 347501.7,\n          \"h1\": 43875.75,\n          \"m5\": 116.89\n        },\n        \"priceChange\": {\n          \"m5\": -0.03,\n          \"h1\": -0.17,\n          \"h6\": 0.21,\n          \"h24\": 2.96\n        },\n        \"liquidity\": {\n          \"usd\": 68332997.01,\n          \"base\": 11346691,\n          \"quote\": 56736\n        }\n      }\n    ]\n  }\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true,
                      "default": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "total": {
                          "type": "integer",
                          "example": 339,
                          "default": 0
                        },
                        "result": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "baseToken": {
                                "type": "object",
                                "properties": {
                                  "address": {
                                    "type": "string",
                                    "example": "0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82"
                                  },
                                  "name": {
                                    "type": "string",
                                    "example": "PancakeSwap Token"
                                  },
                                  "symbol": {
                                    "type": "string",
                                    "example": "Cake"
                                  },
                                  "logo_uri": {
                                    "type": "string",
                                    "example": "https://dbqxolzl7v371.cloudfront.net/150x150.pancakeswap1614939043529.png"
                                  }
                                }
                              },
                              "quoteToken": {
                                "type": "object",
                                "properties": {
                                  "address": {
                                    "type": "string",
                                    "example": "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c"
                                  },
                                  "name": {
                                    "type": "string",
                                    "example": "Wrapped BNB"
                                  },
                                  "symbol": {
                                    "type": "string",
                                    "example": "WBNB"
                                  }
                                }
                              },
                              "priceUsd": {
                                "type": "number",
                                "example": 3.011,
                                "default": 0
                              },
                              "volume": {
                                "type": "object",
                                "properties": {
                                  "h24": {
                                    "type": "number",
                                    "example": 1397761.78,
                                    "default": 0
                                  },
                                  "h6": {
                                    "type": "number",
                                    "example": 347501.7,
                                    "default": 0
                                  },
                                  "h1": {
                                    "type": "number",
                                    "example": 43875.75,
                                    "default": 0
                                  },
                                  "m5": {
                                    "type": "number",
                                    "example": 116.89,
                                    "default": 0
                                  }
                                }
                              },
                              "priceChange": {
                                "type": "object",
                                "properties": {
                                  "m5": {
                                    "type": "number",
                                    "example": -0.03,
                                    "default": 0
                                  },
                                  "h1": {
                                    "type": "number",
                                    "example": -0.17,
                                    "default": 0
                                  },
                                  "h6": {
                                    "type": "number",
                                    "example": 0.21,
                                    "default": 0
                                  },
                                  "h24": {
                                    "type": "number",
                                    "example": 2.96,
                                    "default": 0
                                  }
                                }
                              },
                              "liquidity": {
                                "type": "object",
                                "properties": {
                                  "usd": {
                                    "type": "number",
                                    "example": 68332997.01,
                                    "default": 0
                                  },
                                  "base": {
                                    "type": "integer",
                                    "example": 11346691,
                                    "default": 0
                                  },
                                  "quote": {
                                    "type": "integer",
                                    "example": 56736,
                                    "default": 0
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "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
}
```