get_id_simple_token_price
Query token prices using contract addresses to retrieve USD value, 24hr change, volume, market cap, and last updated timestamp.
Instructions
When using this tool, always use the jq_filter parameter to reduce the response size and improve performance.
Only omit if you're sure you don't need the data.
This endpoint allows you to query one or more token prices using their token contract addresses
Response Schema
{
type: 'object',
properties: {
last_updated_at: {
type: 'number',
description: 'last updated timestamp'
},
usd: {
type: 'number',
description: 'price in USD'
},
usd_24h_change: {
type: 'number',
description: '24hr change in USD'
},
usd_24h_vol: {
type: 'number',
description: '24hr volume in USD'
},
usd_market_cap: {
type: 'number',
description: 'market cap in USD'
}
}
}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| contract_addresses | Yes | the contract addresses of tokens, comma-separated if querying more than 1 token's contract address | |
| id | Yes | ||
| include_24hr_change | No | include 24hr change <br> default: false | |
| include_24hr_vol | No | include 24hr volume, default: false | |
| include_last_updated_at | No | include last updated price time in UNIX , default: false | |
| include_market_cap | No | include market capitalization, default: false | |
| jq_filter | No | A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available. For example: to include only the `name` field in every object of a results array, you can provide ".results[].name". For more information, see the [jq documentation](https://jqlang.org/manual/). | |
| precision | No | decimal place for currency price value | |
| vs_currencies | Yes | target currency of coins, comma-separated if querying more than 1 currency. <br> *refers to [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies). |
Input Schema (JSON Schema)
{
"properties": {
"contract_addresses": {
"description": "the contract addresses of tokens, comma-separated if querying more than 1 token's contract address",
"type": "string"
},
"id": {
"type": "string"
},
"include_24hr_change": {
"description": "include 24hr change <br> default: false",
"type": "boolean"
},
"include_24hr_vol": {
"description": "include 24hr volume, default: false",
"type": "boolean"
},
"include_last_updated_at": {
"description": "include last updated price time in UNIX , default: false",
"type": "boolean"
},
"include_market_cap": {
"description": "include market capitalization, default: false",
"type": "boolean"
},
"jq_filter": {
"description": "A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide \".results[].name\".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).",
"title": "jq Filter",
"type": "string"
},
"precision": {
"description": "decimal place for currency price value",
"enum": [
"full",
"0",
"1",
"2",
"3",
"4",
"5",
"6",
"7",
"8",
"9",
"10",
"11",
"12",
"13",
"14",
"15",
"16",
"17",
"18"
],
"type": "string"
},
"vs_currencies": {
"description": "target currency of coins, comma-separated if querying more than 1 currency. <br> *refers to [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies).",
"type": "string"
}
},
"required": [
"id",
"contract_addresses",
"vs_currencies"
],
"type": "object"
}