# Oracle

### `useGetTokenUsdPrice`

A React hook that fetches the current USD price for supported tokens (B3TR, VET, VTHO) from the VeChain oracle contract.

#### Usage

```typescript
import { useGetTokenUsdPrice } from '@vechain/vechain-kit';

function TokenPrice() {
  const { data: vetPrice, isLoading, error } = useGetTokenUsdPrice('VET');
  
  if (isLoading) return <div>Loading...</div>;
  if (error) return <div>Error fetching price</div>;
  
  return <div>VET Price: ${vetPrice}</div>;
}
```

### Parameters

Fetch the price for the following token symbols: 'B3TR', 'VET', 'VTHO'.

### Returns

The hook returns a TanStack Query result object with the following properties:

| Property  | Type          | Description                                     |
| --------- | ------------- | ----------------------------------------------- |
| data      | number        | The current token price in USD.                 |
| isLoading | boolean       | Indicates if the query is currently loading.    |
| error     | Error \| null | Describes any error that occurred during query. |
| isError   | boolean       | Indicates if there was an error in the query.   |

### Implementation Details

The hook internally:

* Uses the VeChain oracle contract to fetch real-time price data
* Automatically handles network configuration (mainnet/testnet)
* Caches results using TanStack Query
* Only fetches when both Thor connection and network type are available

### Example with Multiple Tokens

```typescript
function TokenPrices() {
  const { data: vetPrice } = useGetTokenUsdPrice('VET');
  const { data: vthoPrice } = useGetTokenUsdPrice('VTHO');
  const { data: b3trPrice } = useGetTokenUsdPrice('B3TR');

  return (
    <div>
      <div>VET: ${vetPrice}</div>
      <div>VTHO: ${vthoPrice}</div>
      <div>B3TR: ${b3trPrice}</div>
    </div>
  );
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.vechainkit.vechain.org/hooks/oracle.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.