> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dzap.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Market Data Tools

> Price, token lookup, trends, predictions, and sentiment.

## `PriceTool`

Token price lookup for one or more addresses.

Input:

* `tokenAddresses: string` (comma-separated)
* `chainId: number`

```ts theme={null}
await sdk.executeTool("PriceTool", {
  tokenAddresses: "0xA0b86991c6218b36c1d19d4a2e9eb0ce3606eB48",
  chainId: 1,
});
```

## `TokenAddressTool`

Resolves symbol to address and decimals from static mappings.

Input:

* `symbol: string`
* `chainId: number`

```ts theme={null}
await sdk.executeTool("TokenAddressTool", { symbol: "USDC", chainId: 42161 });
```

## `DollarToTokenAmountTool`

Converts USD amount to token amount using fetched price.

Input:

* `tokenAddresses: string`
* `chainId: number`
* `amount: number`

```ts theme={null}
await sdk.executeTool("DollarToTokenAmountTool", {
  tokenAddresses: "0xC02aaa39b223FE8D0A0e5C4F27eAD9083C756Cc2",
  chainId: 1,
  amount: 100,
});
```

## `TrendingTokenTool`

Fetches trending tokens from CoinGecko.

```ts theme={null}
await sdk.executeTool("TrendingTokenTool", {});
```

## `TrendingNewsTool`

Fetches recent crypto news. It queries CryptoPanic first and automatically
falls back to a Tavily news search when CryptoPanic is unavailable, so a
`TAVILY_API_KEY` is the practical requirement for reliable results.

Input:

* `tokens: string`

```ts theme={null}
await sdk.executeTool("TrendingNewsTool", { tokens: "ETH,BTC" });
```

## `PricePredictionTool`

Short-horizon inference via Allora.

Input:

* `tokenSymbol: "BTC" | "ETH"`

Timeframe in current implementation: `EIGHT_HOURS`.

```ts theme={null}
await sdk.executeTool("PricePredictionTool", { tokenSymbol: "ETH" });
```

## `SentimentTool`

General text sentiment analysis.

Input:

* `text: string`

```ts theme={null}
await sdk.executeTool("SentimentTool", {
  text: "ETH is showing strong momentum today.",
});
```