models

package
v1.0.1-tekton-ci-beta-18 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jun 17, 2021 License: GPL-2.0 Imports: 21 Imported by: 65

Documentation

Index

Constants

View Source
const (
	WindowYesterday       = 24 * 60 * 60
	Window1h              = 60 * 60
	Window7d              = 7 * 24 * 60 * 60
	Window14d             = 7 * 24 * 60 * 60
	Window30d             = 30 * 24 * 60 * 60
	Window2               = 24 * 60 * 60 * 8
	BufferTTL             = 60 * 60
	BiggestWindow         = Window2
	TimeOutRedis          = time.Duration(time.Second*BiggestWindow + time.Second*BufferTTL)
	TimeOutAssetQuotation = time.Duration(time.Second * WindowYesterday)
)
View Source
const (
	TimeLayoutRedis = "2006-01-02 15:04:05 +0000 UTC"
)
View Source
const (
	WindowVolume = 60 * 60 * 24
)

Variables

This section is empty.

Functions

func StraightRates

func StraightRates(intRates []*InterestRate) map[time.Time]float64

StraightRates returns a map which maps a rate to each day in the time period. This includes (artificial) rate values for non-business days. intRates must be sorted by date in increasing order.

func WeightedRates

func WeightedRates(intRates []*InterestRate, dateInit, dateFinal time.Time, holidays []time.Time, startIndex int) (map[time.Time]float64, int)

WeightedRates returns a map which maps a rate to each business day in the time period given by @dateInit and @dateFinal. Rates are weighted by the rate factor. intRates must be sorted by date in increasing order.

Types

type AssetQuotation added in v1.2.0

type AssetQuotation struct {
	Asset  dia.Asset
	Price  float64
	Source string
	Time   time.Time
}

AssetQuotation is the most recent price point information on an asset.

func (*AssetQuotation) MarshalBinary added in v1.2.0

func (aq *AssetQuotation) MarshalBinary() ([]byte, error)

MarshalBinary for quotations

func (*AssetQuotation) UnmarshalBinary added in v1.2.0

func (aq *AssetQuotation) UnmarshalBinary(data []byte) error

UnmarshalBinary for quotations

type Author

type Author struct {
	Name  string
	Email string
}

type Change

type Change struct {
	USD []CurrencyChange
}

func (*Change) MarshalBinary

func (e *Change) MarshalBinary() ([]byte, error)

MarshalBinary -

func (*Change) UnmarshalBinary

func (e *Change) UnmarshalBinary(data []byte) error

UnmarshalBinary -

type Coin

type Coin struct {
	Symbol             string
	Name               string
	Price              float64
	PriceYesterday     *float64
	VolumeYesterdayUSD *float64
	Time               time.Time
	CirculatingSupply  *float64
	ITIN               string
}

func (*Coin) MarshalBinary

func (e *Coin) MarshalBinary() ([]byte, error)

MarshalBinary -

func (*Coin) UnmarshalBinary

func (e *Coin) UnmarshalBinary(data []byte) error

type CoinSymbolAndName

type CoinSymbolAndName struct {
	Symbol string
	Name   string
}

type Coins

type Coins struct {
	CompleteCoinList []CoinSymbolAndName
	Change           *Change
	Coins            []Coin
}

func (*Coins) MarshalBinary

func (e *Coins) MarshalBinary() ([]byte, error)

MarshalBinary -

func (*Coins) UnmarshalBinary

func (e *Coins) UnmarshalBinary(data []byte) error

UnmarshalBinary -

type CryptoIndex

type CryptoIndex struct {
	// The index has a price, hence is traded, hence must(?) correspond to some underlying asset
	// In case there is no underlying token, just fill the field @Symbol.
	Asset             dia.Asset
	Value             float64
	Price             float64
	Price1h           float64
	Price24h          float64
	Price7d           float64
	Price14d          float64
	Price30d          float64
	Volume24hUSD      float64
	CirculatingSupply float64
	Divisor           float64
	CalculationTime   time.Time
	Constituents      []CryptoIndexConstituent
}

CryptoIndex is the container for API endpoint CryptoIndex

func (*CryptoIndex) MarshalBinary

func (e *CryptoIndex) MarshalBinary() ([]byte, error)

MarshalBinary -

func (*CryptoIndex) UnmarshalBinary

func (e *CryptoIndex) UnmarshalBinary(data []byte) error

UnmarshalBinary -

type CryptoIndexConstituent

type CryptoIndexConstituent struct {
	Asset             dia.Asset
	Price             float64
	PriceYesterday    float64
	PriceYesterweek   float64
	CirculatingSupply float64
	Weight            float64
	Percentage        float64
	CappingFactor     float64
	NumBaseTokens     float64
}

type CryptoIndexMintAmount

type CryptoIndexMintAmount struct {
	Name          string
	Symbol        string
	Address       string
	Amount        uint64
	RebalanceTime time.Time
}

type CurrencyChange

type CurrencyChange struct {
	Symbol        string
	Rate          float64
	RateYesterday float64
}

type DB

type DB struct {
	// contains filtered or unexported fields
}

func NewDataStore

func NewDataStore() (*DB, error)

func NewDataStoreWithOptions

func NewDataStoreWithOptions(withRedis bool, withInflux bool) (*DB, error)

func (*DB) AddAssetQuotationsToBatch added in v1.2.0

func (db *DB) AddAssetQuotationsToBatch(quotations []*AssetQuotation) error

AddAssetQuotationsToBatch is a helper function that adds a slice of quotations to an influx batch.

func (*DB) ExistInterestRate

func (db *DB) ExistInterestRate(symbol, date string) bool

ExistInterestRate returns true if a database entry with given date stamp exists, and false otherwise. @date should be a substring of a string formatted as "yyyy-mm-dd hh:mm:ss".

func (*DB) Flush

func (db *DB) Flush() error

func (*DB) GetAllTrades

func (db *DB) GetAllTrades(t time.Time, maxTrades int) ([]dia.Trade, error)

GetAllTrades returns at most @maxTrades trades from influx with timestamp > @t. Only used by replayInflux option.

func (*DB) GetAssetPriceUSD added in v1.2.0

func (db *DB) GetAssetPriceUSD(asset dia.Asset) (price float64, err error)

GetAssetPriceUSD returns the last price of @asset.

func (*DB) GetAssetPriceUSDCache added in v1.2.0

func (db *DB) GetAssetPriceUSDCache(asset dia.Asset) (price float64, err error)

GetAssetPriceUSDCache returns the last price of @asset from the cache.

func (*DB) GetAssetQuotation added in v1.2.0

func (db *DB) GetAssetQuotation(asset dia.Asset) (*AssetQuotation, error)

GetAssetQuotation returns the latest full quotation for @asset.

func (*DB) GetAssetQuotationCache added in v1.2.0

func (db *DB) GetAssetQuotationCache(asset dia.Asset) (*AssetQuotation, error)

GetAssetQuotationCache returns the latest quotation for @asset from the redis cache.

func (*DB) GetAssetsMarketCap added in v1.2.0

func (db *DB) GetAssetsMarketCap(asset dia.Asset) (float64, error)

GetAssetsMarketCap returns the actual market cap of @asset.

func (*DB) GetAvailablePairs added in v1.2.0

func (db *DB) GetAvailablePairs(exchange string) ([]dia.ExchangePair, error)

GetAvailablePairs a slice of all pairs available in the exchange in the internal redis db

func (*DB) GetCVIInflux

func (db *DB) GetCVIInflux(starttime time.Time, endtime time.Time) ([]dia.CviDataPoint, error)

func (*DB) GetCommitByDate

func (db *DB) GetCommitByDate(user, repository string, date time.Time) (GithubCommit, error)

GetCommitByDate returns the latest commit from @repository of github user @user before @date.

func (*DB) GetCommitByHash

func (db *DB) GetCommitByHash(user, repository, hash string) (GithubCommit, error)

GetCommitByHash returns the commit from @repository of github user @user with hash @hash.

func (*DB) GetCompoundedAvg

func (db *DB) GetCompoundedAvg(symbol string, date time.Time, calDays, daysPerYear int, rounding int) (*InterestRate, error)

GetCompoundedAvg returns the compounded average of the index @symbol over rolling @calDays calendar days.

func (*DB) GetCompoundedAvgDIARange

func (db *DB) GetCompoundedAvgDIARange(symbol string, dateInit, dateFinal time.Time, calDays, daysPerYear int, rounding int) (values []*InterestRate, err error)

GetCompoundedAvgDIARange returns the compounded average DIA index of @symbol over rolling @calDays calendar days.

func (*DB) GetCompoundedAvgRange

func (db *DB) GetCompoundedAvgRange(symbol string, dateInit, dateFinal time.Time, calDays, daysPerYear int, rounding int) (values []*InterestRate, err error)

GetCompoundedAvgRange returns the compounded average of the index @symbol over rolling @calDays calendar days.

func (*DB) GetCompoundedIndex

func (db *DB) GetCompoundedIndex(symbol string, date time.Time, daysPerYear int, rounding int) (*InterestRate, error)

GetCompoundedIndex returns the compounded index over the maximal period of existence of @symbol

func (*DB) GetCompoundedIndexRange

func (db *DB) GetCompoundedIndexRange(symbol string, dateInit, dateFinal time.Time, daysPerYear int, rounding int) (values []*InterestRate, err error)

GetCompoundedIndexRange returns the compounded average of the index @symbol over rolling @calDays calendar days.

func (*DB) GetCompoundedRate

func (db *DB) GetCompoundedRate(symbol string, dateInit, date time.Time, daysPerYear int, rounding int) (*InterestRate, error)

GetCompoundedRate returns the compounded rate for the period @dateInit to @date. It computes the rate for all days for which an entry is present in the database. All other days are assumed to be holidays (or weekends).

func (*DB) GetCryptoIndex

func (db *DB) GetCryptoIndex(starttime time.Time, endtime time.Time, name string) ([]CryptoIndex, error)

func (*DB) GetCryptoIndexConstituentPrice

func (db *DB) GetCryptoIndexConstituentPrice(symbol string, date time.Time) (float64, error)

func (*DB) GetCryptoIndexConstituents

func (db *DB) GetCryptoIndexConstituents(starttime time.Time, endtime time.Time, asset dia.Asset, indexSymbol string) ([]CryptoIndexConstituent, error)

GetCryptoIndexConstituents returns the constituent corresponding to @asset along with underlying information. Necessary and sufficient information is asset's address and blockchain.

func (*DB) GetCurrencyChange

func (db *DB) GetCurrencyChange() (*Change, error)

func (*DB) GetDefiProtocol

func (db *DB) GetDefiProtocol(name string) (dia.DefiProtocol, error)

GetDefiProtocol returns the die protocol struct by name

func (*DB) GetDefiProtocols

func (db *DB) GetDefiProtocols() ([]dia.DefiProtocol, error)

GetDefiProtocols returns a slice of all available DeFi protocols

func (*DB) GetDefiRateInflux

func (db *DB) GetDefiRateInflux(starttime time.Time, endtime time.Time, asset string, protocol string) ([]dia.DefiRate, error)

func (*DB) GetDefiStateInflux

func (db *DB) GetDefiStateInflux(starttime time.Time, endtime time.Time, protocol string) (retval []dia.DefiProtocolState, err error)

func (*DB) GetExchanges

func (db *DB) GetExchanges() (allExchanges []string)

GetExchanges returns all available trading places. Comment: Think about getting the exchanges from redis.

func (*DB) GetFarmingPoolData

func (db *DB) GetFarmingPoolData(starttime, endtime time.Time, protocol, poolID string) ([]FarmingPool, error)

GetFarmingPoolData returns all farming pool states in the given time range time, balance, blocknumber, inputAssets, outputAssets, poolID, protocol, rate

func (*DB) GetFarmingPools

func (db *DB) GetFarmingPools() ([]FarmingPoolType, error)

GetFarmingPools returns all farming pool states in the given time range time, balance, blocknumber, inputAssets, outputAssets, poolID, protocol, rate

func (*DB) GetFilterPoints

func (db *DB) GetFilterPoints(filter string, exchange string, symbol string, scale string, starttime time.Time, endtime time.Time) (*Points, error)

GetFilterPoints returns filter points from either a specific exchange or all exchanges. symbol is mapped to the underlying asset with biggest market cap.

func (*DB) GetFirstDate

func (db *DB) GetFirstDate(symbol string) (time.Time, error)

GetFirstDate returns the oldest date written in the database for the rate with symbol @symbol

func (*DB) GetForeignPriceYesterday

func (db *DB) GetForeignPriceYesterday(symbol, source string) (float64, error)

GetForeignPriceYesterday returns the average price of @symbol on @source from yesterday

func (*DB) GetForeignQuotationInflux

func (db *DB) GetForeignQuotationInflux(symbol, source string, timestamp time.Time) (ForeignQuotation, error)

GetForeignQuotationInflux returns the last quotation of @symbol before @timestamp

func (*DB) GetForeignSymbolsInflux

func (db *DB) GetForeignSymbolsInflux(source string) (symbols []SymbolShort, err error)

GetForeignSymbolsInflux returns a list with all symbols available for quotation from @source, along with their ITIN.

func (*DB) GetIndexPrice added in v1.2.0

func (db *DB) GetIndexPrice(asset dia.Asset, time time.Time) (trade *dia.Trade, err error)

GetIndexPrice returns the price of index represented by @asset. If @asset only consists of a symbol, a different method for price retrieval has to be implemented.

func (*DB) GetInterestRate

func (db *DB) GetInterestRate(symbol, date string) (*InterestRate, error)

GetInterestRate returns the interest rate value for the last time stamp before @date. If @date is an empty string it returns the rate at the latest time stamp. @symbol is the shorthand symbol for the requested interest rate. @date is a string in the format yyyy-mm-dd.

func (*DB) GetInterestRateRange

func (db *DB) GetInterestRateRange(symbol, dateInit, dateFinal string) ([]*InterestRate, error)

GetInterestRateRange returns the interest rate values for a range of timestamps. @symbol is the shorthand symbol for the requested interest rate. @dateInit and @dateFinal are strings in the format yyyy-mm-dd.

func (*DB) GetIssuer

func (db *DB) GetIssuer(symbol string) (string, error)

GetIssuer returns the issuing entity of the rate given by @symbol

func (*DB) GetItinBySymbol

func (db *DB) GetItinBySymbol(symbol string) (dia.ItinToken, error)

func (*DB) GetLastPriceBefore

func (db *DB) GetLastPriceBefore(asset dia.Asset, filter string, exchange string, timestamp time.Time) (Price, error)

func (*DB) GetLastTradeTimeForExchange

func (db *DB) GetLastTradeTimeForExchange(asset dia.Asset, exchange string) (*time.Time, error)

func (*DB) GetLastTrades

func (db *DB) GetLastTrades(asset dia.Asset, exchange string, maxTrades int) ([]dia.Trade, error)

GetLastTrades returns the last @maxTrades of @asset on @exchange. If exchange is empty string it returns trades from all exchanges.

func (*DB) GetLatestCommit

func (db *DB) GetLatestCommit(user, repository string) (GithubCommit, error)

GetLatestCommit returns the latest commit from influx. Returns empty struct and nil if no commits are in the database.

func (*DB) GetLatestSupply

func (db *DB) GetLatestSupply(symbol string) (*dia.Supply, error)

func (*DB) GetOptionMeta

func (db *DB) GetOptionMeta(baseCurrency string) ([]dia.OptionMeta, error)

func (*DB) GetOptionOrderbookDataInflux

func (db *DB) GetOptionOrderbookDataInflux(t dia.OptionMeta) (dia.OptionOrderbookDatum, error)

func (*DB) GetPaxgQuotationGrams

func (db *DB) GetPaxgQuotationGrams() (*Quotation, error)

func (*DB) GetPaxgQuotationOunces

func (db *DB) GetPaxgQuotationOunces() (*Quotation, error)

func (*DB) GetPrice

func (db *DB) GetPrice(asset dia.Asset, exchange string) (float64, error)

func (*DB) GetPrice14d

func (db *DB) GetPrice14d(asset dia.Asset, exchange string) (float64, error)

func (*DB) GetPrice1h

func (db *DB) GetPrice1h(asset dia.Asset, exchange string) (float64, error)

func (*DB) GetPrice30d

func (db *DB) GetPrice30d(asset dia.Asset, exchange string) (float64, error)

func (*DB) GetPrice7d

func (db *DB) GetPrice7d(asset dia.Asset, exchange string) (float64, error)

func (*DB) GetPriceUSD

func (db *DB) GetPriceUSD(symbol string) (float64, error)

func (*DB) GetPriceYesterday

func (db *DB) GetPriceYesterday(asset dia.Asset, exchange string) (float64, error)

func (*DB) GetQuotation

func (db *DB) GetQuotation(symbol string) (*Quotation, error)

func (*DB) GetRates

func (db *DB) GetRates() []string

GetRates returns a (unique) slice of all rates that have been written into the database

func (*DB) GetRatesMeta

func (db *DB) GetRatesMeta() (RatesMeta []InterestRateMeta, err error)

GetRatesMeta returns a list of all available rate symbols along with their first timestamp in the database.

func (*DB) GetSupply

func (db *DB) GetSupply(symbol string, starttime, endtime time.Time) ([]dia.Supply, error)

func (*DB) GetSupplyInflux

func (db *DB) GetSupplyInflux(asset dia.Asset, starttime time.Time, endtime time.Time) ([]dia.Supply, error)

GetSupplyInflux returns supply and circulating supply of @asset. Needs asset.Address and asset.Blockchain. If no time range is given it returns the latest supply.

func (*DB) GetSymbols

func (db *DB) GetSymbols(exchange string) ([]string, error)

func (*DB) GetTopAsset

func (db *DB) GetTopAsset(symbol string, relDB *RelDB) (topAsset dia.Asset, err error)

GetTopAsset returns the asset with highest market cap among all assets with symbol @symbol. This method allows us to use all API endpoints called on a symbol.

func (*DB) GetTradeInflux

func (db *DB) GetTradeInflux(asset dia.Asset, exchange string, timestamp time.Time) (*dia.Trade, error)

GetTradeInflux returns

func (*DB) GetTradePrice14d

func (db *DB) GetTradePrice14d(asset dia.Asset, exchange string) (*dia.Trade, error)

func (*DB) GetTradePrice1h

func (db *DB) GetTradePrice1h(asset dia.Asset, exchange string) (*dia.Trade, error)

func (*DB) GetTradePrice24h

func (db *DB) GetTradePrice24h(asset dia.Asset, exchange string) (*dia.Trade, error)

func (*DB) GetTradePrice30d

func (db *DB) GetTradePrice30d(asset dia.Asset, exchange string) (*dia.Trade, error)

func (*DB) GetTradePrice7d

func (db *DB) GetTradePrice7d(asset dia.Asset, exchange string) (*dia.Trade, error)

func (*DB) GetTradePriceBefore

func (db *DB) GetTradePriceBefore(asset dia.Asset, exchange string, timestamp time.Time) (*dia.Trade, error)

func (*DB) GetVolume

func (db *DB) GetVolume(asset dia.Asset) (*float64, error)

GetVolume returns the 24h trading volume of @asset across exchanges.

func (*DB) GetVolumeInflux

func (db *DB) GetVolumeInflux(asset dia.Asset, starttime time.Time, endtime time.Time) (float64, error)

GetVolumeInflux returns the trade volume of @asset in the time range @starttime - @endtime. It uses the VOL filter from the filter services.

func (*DB) RemoveExpiredOptionMeta

func (db *DB) RemoveExpiredOptionMeta(baseCurrency string) error

func (*DB) SaveCVIInflux

func (db *DB) SaveCVIInflux(cviValue float64, observationTime time.Time) error

func (*DB) SaveFilterInflux

func (db *DB) SaveFilterInflux(filter string, asset dia.Asset, exchange string, value float64, t time.Time) error

SaveFilterInflux stores a filter point in influx.

func (*DB) SaveForeignQuotationInflux

func (db *DB) SaveForeignQuotationInflux(fq ForeignQuotation) error

SaveForeignQuotationInflux stores a quotation which is not from DIA to an influx batch

func (*DB) SaveOptionOrderbookDatumInflux

func (db *DB) SaveOptionOrderbookDatumInflux(t dia.OptionOrderbookDatum) error

func (*DB) SaveSupplyInflux

func (db *DB) SaveSupplyInflux(supply *dia.Supply) error

func (*DB) SaveTradeInflux

func (db *DB) SaveTradeInflux(t *dia.Trade) error

SaveTradeInflux stores a trade in influx. Flushed when more than maxPoints in batch.

func (*DB) SetAssetPriceUSD added in v1.2.0

func (db *DB) SetAssetPriceUSD(asset dia.Asset, price float64, timestamp time.Time) error

SetAssetPriceUSD stores the price of @asset in influx and the caching layer. The latter only holds the most recent price point.

func (*DB) SetAssetQuotation added in v1.2.0

func (db *DB) SetAssetQuotation(quotation *AssetQuotation) error

SetAssetQuotation stores the full quotation of @asset into influx and cache.

func (*DB) SetAssetQuotationCache added in v1.2.0

func (db *DB) SetAssetQuotationCache(quotation *AssetQuotation) (bool, error)

SetAssetQuotationCache stores @quotation in redis cache

func (*DB) SetAvailablePairs added in v1.2.0

func (db *DB) SetAvailablePairs(exchange string, pairs []dia.ExchangePair) error

SetAvailablePairs stores @pairs in redis TO DO: Setter and getter should act on RelDB

func (*DB) SetBatchFiatPriceInflux added in v1.2.0

func (db *DB) SetBatchFiatPriceInflux(fiatQuotations []*FiatQuotation) error

func (*DB) SetCommit

func (db *DB) SetCommit(commit GithubCommit) error

SetCommit stores a github commit in influx

func (*DB) SetCryptoIndex

func (db *DB) SetCryptoIndex(index *CryptoIndex) error

func (*DB) SetCryptoIndexConstituent

func (db *DB) SetCryptoIndexConstituent(constituent *CryptoIndexConstituent, index dia.Asset) error

func (*DB) SetCurrencyChange

func (db *DB) SetCurrencyChange(cc *Change) error

func (*DB) SetDefiProtocol

func (db *DB) SetDefiProtocol(protocol dia.DefiProtocol) error

SetDefiProtocol writes @protocol into redis

func (*DB) SetDefiRateInflux

func (db *DB) SetDefiRateInflux(rate *dia.DefiRate) error

func (*DB) SetDefiStateInflux

func (db *DB) SetDefiStateInflux(state *dia.DefiProtocolState) error

func (*DB) SetFarmingPool

func (db *DB) SetFarmingPool(pool *FarmingPool) error

func (*DB) SetFilter

func (db *DB) SetFilter(filter string, asset dia.Asset, exchange string, value float64, t time.Time) error

SetFilter stores a filter point

func (*DB) SetInterestRate

func (db *DB) SetInterestRate(ir *InterestRate) error

SetInterestRate writes the interest rate struct ir into the Redis database and writes rate type into a set of all available rates (if not done yet).

func (*DB) SetItinData

func (db *DB) SetItinData(token dia.ItinToken) error

func (*DB) SetLastTradeTimeForExchange

func (db *DB) SetLastTradeTimeForExchange(asset dia.Asset, exchange string, t time.Time) error

func (*DB) SetOptionMeta

func (db *DB) SetOptionMeta(optionMeta *dia.OptionMeta) error

func (*DB) SetPriceEUR

func (a *DB) SetPriceEUR(symbol string, price float64) error

func (*DB) SetPriceUSD

func (db *DB) SetPriceUSD(symbol string, price float64) error

func (*DB) SetQuotation

func (db *DB) SetQuotation(quotation *Quotation) error

func (*DB) SetQuotationEUR

func (db *DB) SetQuotationEUR(quotation *Quotation) error

func (*DB) SetSingleFiatPriceRedis added in v1.2.0

func (db *DB) SetSingleFiatPriceRedis(fiatQuotation *FiatQuotation) error

func (*DB) SetSupply

func (db *DB) SetSupply(supply *dia.Supply) error

func (*DB) Sum24HoursExchange

func (db *DB) Sum24HoursExchange(exchange string) (float64, error)

Sum24HoursExchange returns 24h trade volumes summed up for all assets on @exchange, using VOL120 filtered data from influx. TO DO: Rewrite for assets

func (*DB) Sum24HoursInflux

func (db *DB) Sum24HoursInflux(asset dia.Asset, exchange string, filter string) (*float64, error)

Sum24HoursInflux returns the 24h volume of @asset on @exchange using the filter @filter.

func (*DB) WriteBatchInflux

func (db *DB) WriteBatchInflux() error

type Datastore

type Datastore interface {
	GetVolume(asset dia.Asset) (*float64, error)

	// Deprecating
	SetPriceUSD(symbol string, price float64) error
	SetPriceEUR(symbol string, price float64) error
	GetPriceUSD(symbol string) (float64, error)
	GetQuotation(symbol string) (*Quotation, error)
	SetQuotation(quotation *Quotation) error
	SetQuotationEUR(quotation *Quotation) error
	SetBatchFiatPriceInflux(fqs []*FiatQuotation) error
	SetSingleFiatPriceRedis(fiatQuotation *FiatQuotation) error

	GetLatestSupply(string) (*dia.Supply, error)
	GetSupply(string, time.Time, time.Time) ([]dia.Supply, error)
	SetSupply(supply *dia.Supply) error
	GetSupplyInflux(dia.Asset, time.Time, time.Time) ([]dia.Supply, error)
	// Deprecating: GetPairs(exchange string) ([]dia.ExchangePair, error)
	GetSymbols(exchange string) ([]string, error)
	// Deprecating: GetExchangesForSymbol(symbol string) ([]string, error)
	// Deprecating: GetSymbolExchangeDetails(symbol string, exchange string) (*SymbolExchangeDetails, error)
	GetLastTradeTimeForExchange(asset dia.Asset, exchange string) (*time.Time, error)
	SetLastTradeTimeForExchange(asset dia.Asset, exchange string, t time.Time) error
	SaveTradeInflux(t *dia.Trade) error
	GetTradeInflux(dia.Asset, string, time.Time) (*dia.Trade, error)
	SaveFilterInflux(filter string, asset dia.Asset, exchange string, value float64, t time.Time) error
	GetLastTrades(asset dia.Asset, exchange string, maxTrades int) ([]dia.Trade, error)
	GetAllTrades(t time.Time, maxTrades int) ([]dia.Trade, error)
	Flush() error
	GetFilterPoints(filter string, exchange string, symbol string, scale string, starttime time.Time, endtime time.Time) (*Points, error)
	SetFilter(filterName string, asset dia.Asset, exchange string, value float64, t time.Time) error
	GetLastPriceBefore(asset dia.Asset, filter string, exchange string, timestamp time.Time) (Price, error)
	SetAvailablePairs(exchange string, pairs []dia.ExchangePair) error
	GetAvailablePairs(exchange string) ([]dia.ExchangePair, error)
	SetCurrencyChange(cc *Change) error
	GetCurrencyChange() (*Change, error)

	GetExchanges() []string
	SetOptionMeta(optionMeta *dia.OptionMeta) error
	GetOptionMeta(baseCurrency string) ([]dia.OptionMeta, error)
	SaveCVIInflux(float64, time.Time) error
	GetCVIInflux(time.Time, time.Time) ([]dia.CviDataPoint, error)
	GetVolumeInflux(dia.Asset, time.Time, time.Time) (float64, error)
	// Get24Volume(symbol string, exchange string) (float64, error)
	// Get24VolumeExchange(exchange string) (float64, error)
	Sum24HoursInflux(asset dia.Asset, exchange string, filter string) (*float64, error)
	Sum24HoursExchange(exchange string) (float64, error)

	// New Asset pricing methods: 23/02/2021
	SetAssetPriceUSD(asset dia.Asset, price float64, timestamp time.Time) error
	GetAssetPriceUSD(asset dia.Asset) (float64, error)
	SetAssetQuotation(quotation *AssetQuotation) error
	GetAssetQuotation(asset dia.Asset) (*AssetQuotation, error)
	AddAssetQuotationsToBatch(quotations []*AssetQuotation) error
	SetAssetQuotationCache(quotation *AssetQuotation) (bool, error)
	GetAssetQuotationCache(asset dia.Asset) (*AssetQuotation, error)
	GetAssetPriceUSDCache(asset dia.Asset) (price float64, err error)
	GetTopAsset(symbol string, relDB *RelDB) (dia.Asset, error)

	// Market Measures
	GetAssetsMarketCap(asset dia.Asset) (float64, error)

	// Interest rates' methods
	SetInterestRate(ir *InterestRate) error
	GetInterestRate(symbol, date string) (*InterestRate, error)
	GetInterestRateRange(symbol, dateInit, dateFinal string) ([]*InterestRate, error)
	GetRatesMeta() (RatesMeta []InterestRateMeta, err error)
	GetCompoundedIndex(symbol string, date time.Time, daysPerYear int, rounding int) (*InterestRate, error)
	GetCompoundedIndexRange(symbol string, dateInit, dateFinal time.Time, daysPerYear int, rounding int) ([]*InterestRate, error)
	GetCompoundedAvg(symbol string, date time.Time, calDays, daysPerYear int, rounding int) (*InterestRate, error)
	GetCompoundedAvgRange(symbol string, dateInit, dateFinal time.Time, calDays, daysPerYear int, rounding int) ([]*InterestRate, error)
	GetCompoundedAvgDIARange(symbol string, dateInit, dateFinal time.Time, calDays, daysPerYear int, rounding int) ([]*InterestRate, error)

	// Pool  methods
	SetFarmingPool(pr *FarmingPool) error
	GetFarmingPoolData(starttime, endtime time.Time, protocol, poolID string) ([]FarmingPool, error)
	GetFarmingPools() ([]FarmingPoolType, error)

	// Itin methods
	SetItinData(token dia.ItinToken) error
	GetItinBySymbol(symbol string) (dia.ItinToken, error)

	// Defi rates
	SetDefiProtocol(dia.DefiProtocol) error
	GetDefiProtocol(string) (dia.DefiProtocol, error)
	GetDefiProtocols() ([]dia.DefiProtocol, error)

	GetDefiRateInflux(time.Time, time.Time, string, string) ([]dia.DefiRate, error)
	SetDefiRateInflux(rate *dia.DefiRate) error

	GetDefiStateInflux(time.Time, time.Time, string) ([]dia.DefiProtocolState, error)
	SetDefiStateInflux(state *dia.DefiProtocolState) error

	// Foreign quotation methods
	SaveForeignQuotationInflux(fq ForeignQuotation) error
	GetForeignQuotationInflux(symbol, source string, timestamp time.Time) (ForeignQuotation, error)
	GetForeignPriceYesterday(symbol, source string) (float64, error)
	GetForeignSymbolsInflux(source string) (symbols []SymbolShort, err error)

	// Gold token methods
	GetPaxgQuotationOunces() (*Quotation, error)
	GetPaxgQuotationGrams() (*Quotation, error)
	// Crypto Index methods
	GetCryptoIndex(time.Time, time.Time, string) ([]CryptoIndex, error)
	SetCryptoIndex(index *CryptoIndex) error
	GetCryptoIndexConstituents(time.Time, time.Time, dia.Asset, string) ([]CryptoIndexConstituent, error)
	SetCryptoIndexConstituent(*CryptoIndexConstituent, dia.Asset) error
	GetCryptoIndexConstituentPrice(symbol string, date time.Time) (float64, error)
	GetIndexPrice(asset dia.Asset, time time.Time) (*dia.Trade, error)

	// Github methods
	SetCommit(commit GithubCommit) error
	GetCommitByDate(user, repository string, date time.Time) (GithubCommit, error)
	GetCommitByHash(user, repository, hash string) (GithubCommit, error)
	GetLatestCommit(user, repository string) (GithubCommit, error)
}

type DefiScore

type DefiScore struct {
	Protocol        string
	Symbol          string
	Score           float64
	LiquidityIndex  float64
	CollateralIndex float64
}

type FarmingPool

type FarmingPool struct {
	// Rate is the pool rate. More information: https://docs.diadata.org/documentation/methodology/digital-assets/return-rates-in-crypto-farming
	Rate float64
	// Balance is the total supply of pool token
	Balance      float64
	ProtocolName string
	BlockNumber  int64
	PoolID       string // hold pool id respective to protocol
	TimeStamp    time.Time
	// OutputAsset is the list of tokens that you get back for staking.
	OutputAsset []string
	InputAsset  []string // some pools have more than 2 input assets
}

func (*FarmingPool) MarshalBinary

func (fp *FarmingPool) MarshalBinary() ([]byte, error)

func (*FarmingPool) UnmarshalBinary

func (fp *FarmingPool) UnmarshalBinary(data []byte) error

type FarmingPoolType

type FarmingPoolType struct {
	ProtocolName string
	InputAsset   []string
	PoolID       string
}

type FiatQuotation added in v1.2.0

type FiatQuotation struct {
	QuoteCurrency string
	BaseCurrency  string
	Price         float64
	Source        string
	Time          time.Time
}

func (*FiatQuotation) MarshalBinary added in v1.2.0

func (fq *FiatQuotation) MarshalBinary() ([]byte, error)

MarshalBinary for fiat quotations

func (*FiatQuotation) UnmarshalBinary added in v1.2.0

func (fq *FiatQuotation) UnmarshalBinary(data []byte) error

UnmarshalBinary for fiat quotations

type ForeignQuotation

type ForeignQuotation struct {
	Symbol             string
	Name               string
	Price              float64
	PriceYesterday     float64
	VolumeYesterdayUSD float64
	Source             string
	Time               time.Time
	ITIN               string
}

func (*ForeignQuotation) MarshalBinary

func (fq *ForeignQuotation) MarshalBinary() ([]byte, error)

MarshalBinary -

func (*ForeignQuotation) UnmarshalBinary

func (fq *ForeignQuotation) UnmarshalBinary(data []byte) error

UnmarshalBinary -

type GithubCommit

type GithubCommit struct {
	User            string
	Repository      string
	Hash            string
	Timestamp       time.Time
	Author          Author
	NumAdditions    int
	NumDeletions    int
	NumChangedFiles int
	Message         string
}

type InterestRate

type InterestRate struct {
	Symbol          string
	Value           float64
	PublicationTime time.Time
	EffectiveDate   time.Time
	Source          string
}

func (*InterestRate) MarshalBinary

func (e *InterestRate) MarshalBinary() ([]byte, error)

MarshalBinary for interest rates

func (*InterestRate) UnmarshalBinary

func (e *InterestRate) UnmarshalBinary(data []byte) error

UnmarshalBinary for interest rates

type InterestRateMeta

type InterestRateMeta struct {
	Symbol    string
	FirstDate time.Time
	Decimals  int
	Issuer    string
}

type Pairs

type Pairs struct {
	Pairs []dia.ExchangePair
}

type Point

type Point struct {
	UnixTime int64
	Value    float64
}

Point is used exclusively for chart points in the API

type Points

type Points struct {
	DataPoints []clientInfluxdb.Result
}

func (*Points) MarshalBinary

func (e *Points) MarshalBinary() ([]byte, error)

MarshalBinary -

func (*Points) UnmarshalBinary

func (e *Points) UnmarshalBinary(data []byte) error

type Price

type Price struct {
	Symbol string
	Name   string
	Price  float64
	Time   time.Time
}

type Quotation

type Quotation struct {
	Symbol             string
	Name               string
	Price              float64
	PriceYesterday     *float64
	VolumeYesterdayUSD *float64
	Source             string
	Time               time.Time
	ITIN               string
}

Quotation is deprecating. Going to be substituted by AssetQuotation

func (*Quotation) MarshalBinary

func (e *Quotation) MarshalBinary() ([]byte, error)

MarshalBinary for quotations

func (*Quotation) UnmarshalBinary

func (e *Quotation) UnmarshalBinary(data []byte) error

UnmarshalBinary for quotations

type RelDB

type RelDB struct {
	URI string
	// contains filtered or unexported fields
}

RelDB is a relative database with redis caching layer.

func NewCachingLayer

func NewCachingLayer() (*RelDB, error)

NewCachingLayer returns a datastore with redis caching layer and without postgres client.

func NewPostgresDataStore

func NewPostgresDataStore() (*RelDB, error)

NewPostgresDataStore returns a datastore with postgres client and without redis caching layer.

func NewRelDataStore

func NewRelDataStore() (*RelDB, error)

NewRelDataStore returns a datastore with postgres client and redis cache.

func NewRelDataStoreWithOptions

func NewRelDataStoreWithOptions(withPostgres bool, withRedis bool) (*RelDB, error)

NewRelDataStoreWithOptions returns a postgres datastore and/or redis caching layer.

func (*RelDB) Count added in v1.2.0

func (rdb *RelDB) Count() (count uint32, err error)

Count returns the number of assets stored in postgres

func (*RelDB) CountCache added in v1.2.0

func (rdb *RelDB) CountCache() (uint32, error)

CountCache returns the number of assets in the cache

func (*RelDB) GetAllAssets added in v1.2.0

func (rdb *RelDB) GetAllAssets(blockchain string) (assets []dia.Asset, err error)

GetAllAssets returns all assets on @blockchain from asset table.

func (*RelDB) GetAllNFTClasses

func (rdb *RelDB) GetAllNFTClasses(blockchain string) (nftClasses []dia.NFTClass, err error)

GetAllNFTClasses returns all NFT classes on @blockchain.

func (*RelDB) GetAsset added in v1.2.0

func (rdb *RelDB) GetAsset(address, blockchain string) (asset dia.Asset, err error)

GetAsset is the standard method in order to uniquely retrieve an asset from asset table.

func (*RelDB) GetAssetByID added in v1.2.0

func (rdb *RelDB) GetAssetByID(assetID string) (asset dia.Asset, err error)

GetAssetByID returns an asset by its uuid

func (*RelDB) GetAssetCache added in v1.2.0

func (rdb *RelDB) GetAssetCache(assetID string) (dia.Asset, error)

GetAssetCache returns an asset by its asset_id as defined in asset table in postgres

func (*RelDB) GetAssetID added in v1.2.0

func (rdb *RelDB) GetAssetID(asset dia.Asset) (ID string, err error)

GetAssetID returns the unique identifier of @asset in postgres table asset, if the entry exists.

func (*RelDB) GetAssets added in v1.2.0

func (rdb *RelDB) GetAssets(symbol string) (assets []dia.Asset, err error)

func (*RelDB) GetAssetsBySymbolName added in v1.2.0

func (rdb *RelDB) GetAssetsBySymbolName(symbol, name string) (assets []dia.Asset, err error)

GetAssetsBySymbolName returns a (possibly multiple) dia.Asset by its symbol and name from postgres. If @name is an empty string, it returns all assets with @symbol. If @symbol is an empty string, it returns all assets with @name.

func (*RelDB) GetBlockchain added in v1.2.0

func (rdb *RelDB) GetBlockchain(name string) (blockchain dia.BlockChain, err error)

func (*RelDB) GetExchangePair added in v1.2.0

func (rdb *RelDB) GetExchangePair(exchange string, foreignname string) (dia.ExchangePair, error)

GetExchangePair returns the unique exchange pair given by @exchange and @foreignname from postgres. It also returns the underlying pair if existent.

func (*RelDB) GetExchangePairCache added in v1.2.0

func (rdb *RelDB) GetExchangePairCache(exchange string, foreignName string) (dia.ExchangePair, error)

GetExchangePairCache returns an exchange pair by @exchange and @foreigName

func (*RelDB) GetExchangePairSymbols added in v1.2.0

func (rdb *RelDB) GetExchangePairSymbols(exchange string) (pairs []dia.ExchangePair, err error)

GetExchangePairSymbols returns all foreign names on @exchange from exchangepair table.

func (*RelDB) GetExchangeSymbolAssetID added in v1.2.0

func (rdb *RelDB) GetExchangeSymbolAssetID(exchange string, symbol string) (assetID string, verified bool, err error)

GetExchangeSymbolAssetID returns the ID of the unique asset associated to @symbol on @exchange in case the symbol is verified. An empty string if not.

func (*RelDB) GetExchangeSymbols added in v1.2.0

func (rdb *RelDB) GetExchangeSymbols(exchange string) (symbols []string, err error)

GetExchangeSymbols returns all symbols traded on @exchange

func (*RelDB) GetExchangesForSymbol added in v1.2.0

func (rdb *RelDB) GetExchangesForSymbol(symbol string) (exchanges []string, err error)

func (*RelDB) GetFiatAssetBySymbol added in v1.2.0

func (rdb *RelDB) GetFiatAssetBySymbol(symbol string) (asset dia.Asset, err error)

GetFiatAssetBySymbol returns a fiat asset by its symbol. This is possible as fiat currencies are uniquely defined by their symbol.

func (*RelDB) GetKeyAsset added in v1.2.0

func (rdb *RelDB) GetKeyAsset(asset dia.Asset) (string, error)

GetKeyAsset returns an asset's key in the redis cache of the asset table. @assetID refers to the primary key asset_id in the asset table.

func (*RelDB) GetKeys

func (rdb *RelDB) GetKeys(table string) (keys []string, err error)

GetKeys returns a slice of strings holding the names of the keys of @table in postgres

func (*RelDB) GetLastBlockNFTTrade

func (rdb *RelDB) GetLastBlockNFTTrade(nft dia.NFT) (*big.Int, error)

func (*RelDB) GetNFT

func (rdb *RelDB) GetNFT(address common.Address, tokenID uint64) (dia.NFT, error)

func (*RelDB) GetNFTCategories

func (rdb *RelDB) GetNFTCategories() (categories []string, err error)

GetNFTCategories returns all available NFT categories.

func (*RelDB) GetNFTClassID

func (rdb *RelDB) GetNFTClassID(address common.Address, blockchain string) (ID string, err error)

func (*RelDB) GetNFTClasses

func (rdb *RelDB) GetNFTClasses(limit, offset uint64) (nftClasses []dia.NFTClass, err error)

GetNFTClassPage returns @limit NFT classes with @offset.

func (*RelDB) GetPage added in v1.2.0

func (rdb *RelDB) GetPage(pageNumber uint32) (assets []dia.Asset, hasNextPage bool, err error)

GetPage returns assets per page number. @hasNext is true iff there is a non-empty next page.

func (*RelDB) GetPairs added in v1.2.0

func (rdb *RelDB) GetPairs(exchange string) (pairs []dia.ExchangePair, err error)

GetPairs returns all exchangepairs on @exchange. For exchange=="" it returns all exchangepairs across exchanges.

func (*RelDB) GetUnverifiedExchangeSymbols added in v1.2.0

func (rdb *RelDB) GetUnverifiedExchangeSymbols(exchange string) (symbols []string, err error)

func (*RelDB) IdentifyAsset added in v1.2.0

func (rdb *RelDB) IdentifyAsset(asset dia.Asset) (assets []dia.Asset, err error)

IdentifyAsset looks for all assets in postgres which match the non-null fields in @asset Comment 1: The only critical field is @Decimals, as this is initialized with 0, while an asset is allowed to have zero decimals as well (for instance sngls, trxc). Comment 2: Should we add a preprocessing step in which notation is corrected corresponding to the notation in the underlying contract on the blockchain? Comment 3: Can we improve this? How to treat cases like CoinBase emitting symbol name 'Wrapped Bitcoin' instead of the correct 'Wrapped BTC', or 'United States Dollar' instead of 'United States dollar'? On idea would be to add a table with alternative names for symbol tickers, so WBTC -> [Wrapped Bitcoin, Wrapped bitcoin, Wrapped BTC,...]

func (*RelDB) SetAsset added in v1.2.0

func (rdb *RelDB) SetAsset(asset dia.Asset) error

SetAsset stores an asset into postgres.

func (*RelDB) SetAssetCache added in v1.2.0

func (rdb *RelDB) SetAssetCache(asset dia.Asset) error

SetAssetCache stores @asset in redis, using its primary key in postgres as key. As a consequence, @asset is only cached iff it exists in postgres.

func (*RelDB) SetExchangePair added in v1.2.0

func (rdb *RelDB) SetExchangePair(exchange string, pair dia.ExchangePair, cache bool) error

SetExchangePair adds @pair to exchangepair table. If cache==true, it is also cached into redis

func (*RelDB) SetExchangePairCache added in v1.2.0

func (rdb *RelDB) SetExchangePairCache(exchange string, pair dia.ExchangePair) error

SetExchangePairCache stores @pairs in redis

func (*RelDB) SetExchangeSymbol added in v1.2.0

func (rdb *RelDB) SetExchangeSymbol(exchange string, symbol string) error

SetExchangeSymbol writes unique data into exchangesymbol table if not yet in there.

func (*RelDB) SetNFT

func (rdb *RelDB) SetNFT(nft dia.NFT) error

func (*RelDB) SetNFTClass

func (rdb *RelDB) SetNFTClass(nftClass dia.NFTClass) error

SetNFTClass stores @nftClass in postgres.

func (*RelDB) SetNFTTrade

func (rdb *RelDB) SetNFTTrade(trade dia.NFTTrade) error

func (*RelDB) UpdateNFTClassCategory

func (rdb *RelDB) UpdateNFTClassCategory(nftclassID string, category string) (bool, error)

func (*RelDB) VerifyExchangeSymbol added in v1.2.0

func (rdb *RelDB) VerifyExchangeSymbol(exchange string, symbol string, assetID string) (bool, error)

VerifyExchangeSymbol verifies @symbol on @exchange and maps it uniquely to @assetID in asset table. It returns true if symbol,exchange is present and succesfully updated.

type RelDatastore

type RelDatastore interface {

	// --- Assets methods ---
	// --------- Persistent ---------
	SetAsset(asset dia.Asset) error
	GetAsset(address, blockchain string) (dia.Asset, error)
	GetAssetByID(ID string) (dia.Asset, error)
	GetAssetBySymbolName(symbol, name string) ([]dia.Asset, error)
	GetAllAssets(blockchain string) ([]dia.Asset, error)
	GetFiatAssetBySymbol(symbol string) (asset dia.Asset, err error)
	IdentifyAsset(asset dia.Asset) ([]dia.Asset, error)
	GetAssetID(asset dia.Asset) (string, error)
	GetPage(pageNumber uint32) ([]dia.Asset, bool, error)
	Count() (uint32, error)

	// --------------- asset methods for exchanges ---------------
	SetExchangePair(exchange string, pair dia.ExchangePair)
	GetExchangePair(exchange string, foreignname string) (exchangepair dia.ExchangePair, err error)
	GetExchangePairSymbols(exchange string) ([]dia.ExchangePair, error)
	GetPairs(exchange string) ([]dia.ExchangePair, error)
	SetExchangeSymbol(exchange string, symbol string) error
	GetExchangeSymbols(exchange string) ([]string, error)
	GetUnverifiedExchangeSymbols(exchange string) ([]string, error)
	VerifyExchangeSymbol(exchange string, symbol string, assetID string) (bool, error)
	GetExchangeSymbolAssetID(exchange string, symbol string) (string, bool, error)

	// ----------------- blockchain methods -------------------
	GetBlockchain(name string) (dia.BlockChain, error)

	// ------ Caching ------
	SetAssetCache(asset dia.Asset) error
	GetAssetCache(symbol, name string) (dia.Asset, error)
	SetExchangePairCache(exchange string, pair dia.ExchangePair) error
	GetExchangePairCache(exchange string, foreignName string) (dia.ExchangePair, error)
	CountCache() (uint32, error)

	// ---------------- NFT methods -------------------
	SetNFTClass(nftClass dia.NFTClass) error
	GetAllNFTClasses(blockchain string) (nftClasses []dia.NFTClass, err error)
	GetNFTClasses(limit, offset uint64) (nftClasses []dia.NFTClass, err error)
	GetNFTClassID(address common.Address, blockchain string) (ID string, err error)
	UpdateNFTClassCategory(nftclassID string, category string) (bool, error)
	GetNFTCategories() ([]string, error)

	SetNFT(nft dia.NFT) error
	GetNFT(address common.Address, tokenID uint64) (dia.NFT, error)
	SetNFTTrade(trade dia.NFTTrade) error
	GetLastBlockNFTTrade(nft dia.NFT) (*big.Int, error)

	// General methods
	GetKeys(table string) ([]string, error)
}

RelDatastore is a (persistent) relational database with an additional redis caching layer

type SymbolDetails

type SymbolDetails struct {
	Change    *Change
	Coin      Coin
	Rank      int
	Exchanges []SymbolExchangeDetails
	Gfx1      *Points
}

SymbolDetails is used for API return values

func (*SymbolDetails) MarshalBinary

func (e *SymbolDetails) MarshalBinary() ([]byte, error)

MarshalBinary -

func (*SymbolDetails) UnmarshalBinary

func (e *SymbolDetails) UnmarshalBinary(data []byte) error

UnmarshalBinary -

type SymbolExchangeDetails

type SymbolExchangeDetails struct {
	Name               string
	Price              float64
	PriceYesterday     *float64
	VolumeYesterdayUSD *float64
	Time               *time.Time
	LastTrades         []dia.Trade
}

type SymbolShort

type SymbolShort struct {
	Symbol string
	ITIN   string
}

SymbolShort is used in ForeignQuotation. TO DO: Switch from ITIN to Address/Identifier

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL