get_simple_price
Query cryptocurrency prices by coin IDs or symbols to retrieve current values in specified currencies, with options for market data and response filtering.
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 the prices of one or more coins by using their unique Coin API IDs
Response Schema
{
$ref: '#/$defs/price_get_response',
$defs: {
price_get_response: {
type: 'object',
additionalProperties: true
}
}
}
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| vs_currencies | Yes | target currency of coins, comma-separated if querying more than 1 currency. *refers to [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies). | |
| ids | No | coins' IDs, comma-separated if querying more than 1 coin. *refers to [`/coins/list`](/reference/coins-list). | |
| include_24hr_change | No | include 24hr change percentage, 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 | |
| include_tokens | No | for `symbols` lookups, specify `all` to include all matching tokens Default `top` returns top-ranked tokens (by market cap or volume) | |
| names | No | coins' names, comma-separated if querying more than 1 coin. | |
| precision | No | decimal place for currency price value | |
| symbols | No | coins' symbols, comma-separated if querying more than 1 coin. | |
| 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/). |