> For the complete documentation index, see [llms.txt](https://docs-v4.venus.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-v4.venus.io/technical-reference/reference-oracle/oracles/binance-oracle.md).

# BinanceOracle

## BinanceOracle

This oracle fetches price of assets from Binance.

## Solidity API

#### sidRegistryAddress

Used to fetch feed registry address.

```solidity
address sidRegistryAddress
```

***

#### BNB\_ADDR

Set this as asset address for BNB. This is the underlying address for vBNB

```solidity
address BNB_ADDR
```

***

#### maxStalePeriod

Max stale period configuration for assets

```solidity
mapping(string => uint256) maxStalePeriod
```

***

#### symbols

Override symbols to be compatible with Binance feed registry

```solidity
mapping(string => string) symbols
```

***

#### feedRegistryAddress

Used to fetch price of assets used directly when space ID is not supported by current chain.

```solidity
address feedRegistryAddress
```

***

#### constructor

Constructor for the implementation contract.

```solidity
constructor() public
```

***

#### initialize

Sets the contracts required to fetch prices

```solidity
function initialize(address _sidRegistryAddress, address _accessControlManager) external
```

**Parameters**

| Name                   | Type    | Description                                    |
| ---------------------- | ------- | ---------------------------------------------- |
| \_sidRegistryAddress   | address | Address of SID registry                        |
| \_accessControlManager | address | Address of the access control manager contract |

***

#### setMaxStalePeriod

Used to set the max stale period of an asset

```solidity
function setMaxStalePeriod(string symbol, uint256 _maxStalePeriod) external
```

**Parameters**

| Name             | Type    | Description             |
| ---------------- | ------- | ----------------------- |
| symbol           | string  | The symbol of the asset |
| \_maxStalePeriod | uint256 | The max stake period    |

***

#### setSymbolOverride

Used to override a symbol when fetching price

```solidity
function setSymbolOverride(string symbol, string overrideSymbol) external
```

**Parameters**

| Name           | Type   | Description               |
| -------------- | ------ | ------------------------- |
| symbol         | string | The symbol to override    |
| overrideSymbol | string | The symbol after override |

***

#### setFeedRegistryAddress

Used to set feed registry address when current chain does not support space ID.

```solidity
function setFeedRegistryAddress(address newfeedRegistryAddress) external
```

**Parameters**

| Name                   | Type    | Description                   |
| ---------------------- | ------- | ----------------------------- |
| newfeedRegistryAddress | address | Address of new feed registry. |

***

#### getFeedRegistryAddress

Uses Space ID to fetch the feed registry address

```solidity
function getFeedRegistryAddress() public view returns (address)
```

**Return Values**

| Name | Type    | Description                                                  |
| ---- | ------- | ------------------------------------------------------------ |
| \[0] | address | feedRegistryAddress Address of binance oracle feed registry. |

***

#### getPrice

Gets the price of a asset from the binance oracle

```solidity
function getPrice(address asset) public view returns (uint256)
```

**Parameters**

| Name  | Type    | Description          |
| ----- | ------- | -------------------- |
| asset | address | Address of the asset |

**Return Values**

| Name | Type    | Description  |
| ---- | ------- | ------------ |
| \[0] | uint256 | Price in USD |

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs-v4.venus.io/technical-reference/reference-oracle/oracles/binance-oracle.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.