Skip to content

Latest commit

 

History

History
98 lines (60 loc) · 3.46 KB

SpotPrice.md

File metadata and controls

98 lines (60 loc) · 3.46 KB
Raw

Spot Price Feeds

Query Name

  • SpotPrice

Query Description

This query returns the spot price of an asset in a specified currency.

Query Parameters

The SpotPrice query has two parameters, which specify the pricing pair.

  1. asset
    • description: Asset ID (e.g. BTC)
    • value type: string
  2. currency
    • description: Selected currency (e.g. USD)
    • value type: string

To request new spot price pair, please reach out to the Tellor team or make an issue/PR in this repository

Response Type

The query response will consist of a single 256-bit value in the following format:

  • abi_type: ufixed256x18 (18 decimals of precision)
  • packed: false

Examples

BTC/USD Spot Price

Query Descriptor:

{"type":"SpotPrice","asset":"btc","currency":"usd"}

queryData:

abi.encode("SpotPrice", abi.encode("btc", "usd"))

0x00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000953706f745072696365000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c0000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000003627463000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000037573640000000000000000000000000000000000000000000000000000000000

queryID:

keccak256(queryData)

0xa6f013ee236804827b77696d350e9f0ac3e879328f2a3021d473a0b778ad78ac

TRB/USD Spot Price

Query Descriptor:

{"type":"SpotPrice","asset":"trb","currency":"usd"}

queryData:

abi.encode("SpotPrice", abi.encode("trb", "usd"))

0x00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000953706f745072696365000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c0000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000003747262000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000037573640000000000000000000000000000000000000000000000000000000000

queryID:

keccak256(queryData)

0x5c13cd9c97dbb98f2429c101a2a8150e6c7a0ddaff6124ee176a3a411067ded0

Encoding/Decoding

A value of 99.9 would be submitted on-chain using the following bytes:

0x0000000000000000000000000000000000000000000000056a6418b505860000

Dispute Considerations

Reporters should use care in selecting data sources and choosing the algorithm to combine them.

  • Multiple sources should be used whenever possible.
  • When retrieving data directly from exchanges, feed users might expect that exchanges with lower volumes have their prices weighted accordingly to avoid erratic results.
  • Care should also be used when retrieving data from aggregators.
  • It is the reporters responsibility to ensure that the feed result is reasonable enough for a community consensus, otherwise it may be subject to dispute.
  • If a reasonable value cannot be determined, a value should not be submitted