jmagly/build.teztools.io

Build blockchain powered applications with scripts and tools built against teztools.io infrastructure

build.teztools.io

Build blockchain powered applications with scripts and tools built against teztools.io infrastructure.

Currently this GitHub is the primary home of the documetation and samples, this will over time transition to a site hosted @ build.teztools.io

API Endpoints

BASE URI: https://api.teztools.io/v1/

No api key is currently needed.

If the application you plan to use with the TezTools API will make a large number of requests please contact us so we can ensure we are able to support you!

General

/v1/prices

Full price data for all tracked tokens

uses: loading price data for multiple tokens with 1 request. ex: https://api.teztools.io/v1/prices

/v1/prices-live

Live price data, only tokens from the latest block

uses: small updates of just the last block ex: https://api.teztools.io/v1/prices-live

/v1/contracts

Full list of all tracked token contract data (token and quipu contracts)

uses: loading list of all contracts ex: https://api.teztools.io/v1/contracts

/v1/blocks-live

Live block data, only blocks and contracts from latest block

uses: detect when a block is done ready for read, look for contract usage ex: https://api.teztools.io/v1/blocks-live

/v1/xtz-price

Tezos coin price pulled from CoinGecko every 10min.

uses: get current tezos price for live fiat display calulations ex: https://api.teztools.io/v1/xtz-price

/v1/community

Community provided metadata, the same is merged into prices and contracts endpoints

uses: review community data ex: https://api.teztools.io/v1/community

/v1/blocked

Tokens removed from API data due technical issues or duplicate tokens created by mistake by the creator.

Will eventually be part of a commuity-based curation system.

uses: review blocked tokens ex: https://api.teztools.io/v1/blocked

Token Specific

TOKENADDRESS_TOKENID or TOKENADDRESS?

Token specific endpoints should reffered to using the token address (omit the underscore) for FA1.2 tokens and token address with token ID for FA2 tokens.

ex FA1.2 Endpoint

https://api.teztools.io/v1/KT1VYsVfmobT7rsMVivvZ4J8i3bPiqz12NaH/price

ex. FA2 Endpoint https://api.teztools.io/v1/KT18fp5rcTW7mbWDmzFwjLDUhs5MeJmagDSZ_11/price

To determine if a token is an FA1.2 or an FA2 you can look for the existance of the tokenId field or check the type field which indicates the token type.

/v1/TOKENADDRESS_TOKENID/price

individual token price

uses: single token price monitor ex: https://api.teztools.io/v1/KT18fp5rcTW7mbWDmzFwjLDUhs5MeJmagDSZ_11/price

/v1/TOKENADDRESS_TOKENID/contract

individual token contract

uses: single token metadata
ex: https://api.teztools.io/v1/KT18fp5rcTW7mbWDmzFwjLDUhs5MeJmagDSZ_11/contract

/v1/TOKENADDRESS_TOKENID/price-history

token price history (beta)

uses: single token metadata
ex: https://api.teztools.io/v1/KT18fp5rcTW7mbWDmzFwjLDUhs5MeJmagDSZ_11/price-history

/v1/TOKENADDRESS_TOKENID/pools/POOLADDRESS/ledger

pool specific ledger

/v1/TOKENADDRESS_TOKENID/pools/POOLADDRESS/aggregate_daily

pool specific aggregate with moving averages daily scope

/v1/TOKENADDRESS_TOKENID/pools<POOLADDRESS/aggregate_weekly

pool specific aggregate with moving averages weekly scope

/v1/TOKENADDRESS_TOKENID/pools/POOLADDRESS/aggregate_monthly

pool specific aggregate with moving averages monthly scope

build.teztools.io's Issues

API endpoint for current and historical prices of FA1.2 and FA2 tokens on many dexes

Hi I I would like to add my "idea" for an API endpoint for tezos token prices.

So for FA2 and FA1.2 tokens there is no endpoint to get historical price or "live" price besides the teztools option. Because teztools managed to do it I think teztools is able to implement something like this?
The API endpoint should allow to query tokens using the contract address which is unique to a given token.

Knowing the contract address for youves uUSD
KT1XRPEPXbZK25r3Htzp2o1x7xdMMmfocKNW

I should be able to query with Teztools and get the current prices

Now the question some might ask is "But there are more decentralised exchanges so there are different prices, how to do that?"

A very good example is how coingecko does it. They have a separate object for every exchange they gather/track the data.

I dont say teztools api should track every dex. But for example the top 2-3?

then you would have something like this:

{
Quipu:{
"base": "uUSD",
"target": "XTZ",
"lastprice": 1,
"volume": "157824452",
"bid_ask_spread_percentage": "0.2",
"timestamp": "2022-04-27T21:10:16+00:00",
"last_trade_at": "2022-04-26T21:10:16+00:00",
"trade_url": "quipuswap dot com/pair"
}
Spicy:{
"base": "uUSD",
"target": "XTZ",
"lastprice": 1,
"volume": "157824452",
"bid_ask_spread_percentage": "0.2",
"timestamp": "2022-04-27T21:10:16+00:00",
"last_trade_at": "2022-04-26T21:10:16+00:00",
"trade_url": "spicyswap dot com/pair"
}
}

Then people can easily get the data and build on top of it.
Since a year people are hoping for coingecko, cmc api but lets dont wait and integrate this for teztools. 🙂

My example screenshot is taken from this example here.
https://api.coingecko.com/api/v3/coins/ethereum/contract/0x0d8775f648430679a709e98d2b0cb6250d2887ef

Tacoz TCZ Price is not displayed correctly

The Tacoz TCZ price does not show up correctly, due to that the estimated value on "your inventory" page is incorrect.

Contract Address: KT1GGxCNiJ7yaBAH4hAw5AHXbP3PSmAiy3wK

organize token column by pool size/name/price change over 24 hourse

would love this feature, could just copy an exchanges method of column organization, most are the same.

Please add a switch account feature

Hey, it would be great if you can add besides the disconnect button a switch account feature like crunchy has. I have many accounts in my temple and everytime connecting and disconnecting is nothing big but after some time a bit tiresome. The switch account feature on crunchy is a smooth experience.

Any idea why this override is not taking place?

build.teztools.io/communitydata/community.json

Line 655 in 03d0fa2

"thumbnailUri": "https://ipfs.io/ipfs/QmNUmoRJPJhZWMaFy1XB6BmQQpZcfrsWbjD1WQJbZgNb9t"