Entities

Entities define the schema of the subgraph, and represent the data that can be queried. Within each entity are sets of fields that store useful information related to the entity. Below is a list of the available entities within the PYESwap Subgraph, and descriptions for the available fields.

To see an interactive sandbox of all entities see the Graph Explorer.

Each entity is defined with a value type, which will always be a base AssemblyScript type, or a custom type provided by The Graph's custom TypeScript library. For more information on value types see here.

PYESwap Factory

The PYESwap Factory entity is responsible for storing aggregate information across all PYESwap pairs. It can be used to view stats about total liquidity, volume, amount of pairs and more. There is only one PYESwapFactory entity in the subgraph.

Field Name	Value Type	Description
id	ID	factory address
totalPairs	BigInt	amount of pairs created by the PYESwap factory
totalTransactions	BigInt	all time amount of transactions across all pairs
totalVolumeUSD	BigDecimal	all time USD volume across all pairs (USD is derived)
totalVolumeBNB	BigDecimal	all time volume in BNB across all pairs (BNB is derived)
untrackedVolumeUSD	BigDecimal	untrackedVol
totalLiquidityUSD	BigDecimal	total liquidity across all pairs stored as a derived USD amount
totalLiquidityBNB	BigDecimal	total liquidity across all pairs stored as a derived BNB amount

Token

Stores aggregated information for a specific token across all pairs that token is included in.

Field Name	Value Type	Description
id	ID	token address
name	String	token name
symbol	String	token symbol
decimals	BigInt	token decimals
tradeVolume	BigDecimal	amount of token traded all time across all pairs
tradeVolumeUSD	BigDecimal	amount of token in USD traded all time across pairs (only for tokens with liquidity above minimum threshold)
untrackedVolumeUSD	BigDecimal	amount of token in USD traded all time across pairs (no minimum liquidity threshold)
totalTransactions	BigInt	amount of transactions all time in pairs including token
totalLiquidity	BigDecimal	total amount of token provided as liquidity across all pairs
derivedBNB	BigDecimal	BNB per token
derivedUSD	BigDecimal
tokenDayData	[TokenDayData]
pairDayDataBase	[PairDayData]
pairDayDataQuote	[PairDayData]
pairBase	[Pair]
pairQuote	[Pair]

Pair

Information about a pair. Includes references to each token within the pair, volume information, liquidity information, and more. The pair entity mirrors the pair smart contract, and also contains aggregated information about use.

Field Name	Value Type	Description
id	ID	pair contract address
name	String	name
token0	Token	reference to token0 as stored in pair contract
token1	Token	reference to token1 as stored in pair contract
reserve0	BigDecimal	reserve of token0
reserve1	BigDecimal	reserve of token1
totalSupply	BigDecimal	total supply of liquidity token distributed to LPs
reserveBNB	BigDecimal	total liquidity in pair stored as an amount of BNB
reserveUSD	BigDecimal	total liquidity amount in pair stored as an amount of USD
trackedReserveBNB	BigDecimal	total liquidity with only tracked amount (see tracked amounts)
token0Price	BigDecimal	token0 per token1
token1Price	BigDecimal	token1 per token0
volumeToken0	BigDecimal	amount of token0 swapped on this pair
volumeToken1	BigDecimal	amount of token1 swapped on this pair
volumeUSD	BigDecimal	total amount swapped all time in this pair stored in USD (only tracked if USD liquidity is above minimum threshold)
untrackedVolumeUSD	BigDecimal	total amount swapped all time in this pair stored in USD, no minimum liquidity threshold
totalTransactions	BigInt	all time amount of transactions on this pair
block	BigInt
timestamp	BigInt	timestamp contract was created
pairHourData	[PairHourData]
mints	[Mint]
burns	[Burn]
swaps	[Swap]

User

A user entity is created for any address that provides liquidity to a pool on PYESwap. This entity can be used to track open positions for users. LiquidyPosition entities can be referenced to get specific data about each position.

Field Name	Value Type	Description
id	ID	user address
liquidityPositions	[LiquidityPosition]	array of all liquidity positions user has open
usdSwapped	BigDecimal	total USD value swapped

LiquidityPositiion

This entity is used to store data about a user's liquidity position. This information, along with information from the pair itself can be used to provide position sizes, token deposits, and more.

Field Name	Value Type	Description
id	ID	user address and pair address concatenated with a dash
user	User	reference to user
pair	Pair	reference to the pair liquidity is being provided on
liquidityTokenBalance	BigDecimal	amount of LP tokens minted for this position

Transaction

Transaction entities are created for each Binance Smartchain transaction that contains an interaction within PYESwap contracts. This subgraph tracks Mint, Burn, and Swap events on the PYESwap core contracts. Each transaction contains 3 arrays, and at least one of these arrays has a length of 1.

Field Name	Value Type	Description
id	ID	Binance Smartchain transaction hash
block	BigInt	block transaction was mined in
timestamp	BigInt	timestamp for transaction
mints	[Mint]	array of Mint events within the transaction, 0 or greater
burns	[Burn]	array of Burn events within transaction, 0 or greater
swaps	[Swap]	array of Swap events within transaction, 0 or greater

Mint

Mint entities are created for every emitted Mint event on the PYESwap core contracts. The Mint entity stores key data about the event like token amounts, who sent the transaction, who received the liquidity, and more. This entity can be used to track liquidity provisions on pairs.

Field Name	Value Type	Description
id	ID	Transaction hash plus index in the transaction mint array
transaction	Transaction	reference to the transaction Mint was included in
timestamp	BigInt	timestamp of Mint, used to sort recent liquidity provisions
pair	Pair	reference to pair
to	Bytes	recipient of liquidity tokens
liquidity	BigDecimal	amount of liquidity tokens minted
sender	Bytes	address that initiated the liquidity provision
amount0	BigDecimal	amount of token0 provided
amount1	BigDecimal	amount of token1 provided
logIndex	BigInt	index in the transaction event was emitted
amountUSD	BigDecimal	derived USD value of token0 amount plus token1 amount
feeTo	Bytes	address of fee recipient (if fee is on)
feeLiquidity	BigDecimal	amount of liquidity sent to fee recipient (if fee is on)

Burn

Burn entities are created for every emitted Burn event on the PYESwap core contracts. The Burn entity stores key data about the event like token amounts, who burned LP tokens, who received tokens, and more. This entity can be used to track liquidity removals on pairs.

Field Name	Value Type	Description
id	ID	Transaction hash plus index in the transaction burn array
transaction	Transaction	reference to the transaction Burn was included in
timestamp	BigInt	timestamp of Burn, used to sort recent liquidity removals
pair	Pair	reference to pair
liquidity	BigDecimal	amount of liquidity tokens burned
sender	Bytes	address that initiated the liquidity removal
amount0	BigDecimal	amount of token0 removed
amount1	BigDecimal	amount of token1 removed
to	Bytes	recipient of tokens
logIndex	BigInt	index in the transaction event was emitted
amountUSD	BigDecimal	derived USD value of token0 amount plus token1 amount
needsComplete	Boolean
feeTo	Bytes	address of fee recipient (if fee is on)
feeLiquidity	BigDecimal	amount of tokens sent to fee recipient (if fee is on)

Swap

Swap entities are created for each token swap within a pair. The Swap entity can be used to get things like swap size (in tokens and USD), sender, recipient and more. See the Swap overview page for more information on amounts.

Field Name	Value Type	Description
id	ID	transaction hash plus index in Transaction swap array
transaction	Transaction	reference to transaction swap was included in
timestamp	BigInt	timestamp of swap, used for sorted lookups
pair	Pair	reference to pair
sender	Bytes	address that initiated the swap
from	Bytes	​
amount0In	BigDecimal	amount of token0 sold
amount1In	BigDecimal	amount of token1 sold
amount0Out	BigDecimal	amount of token0 received
amount1Out	BigDecimal	amount of token1 received
to	Bytes	recipient of output tokens
logIndex	BigInt	event index within transaction
amountUSD	BigDecimal	derived amount of tokens sold in USD

Bundle

The Bundle is used as a global store of derived BNB price in USD. Because there is no guaranteed common base token across pairs, a global reference of USD price is useful for deriving other USD values. The Bundle entity stores an updated weighted average of BNB<->Stablecoin pair prices. This provides a strong estimate for the USD price of BNB that can be used in other places in the subgraph.

Field Name	Value Type	Description
id	ID	constant 1
bnbPrice	BigDecimal	derived price of BNB in USD based on stablecoin pairs

Historical Entities

The subgraph tracks aggregated information grouped by days to provide insights to daily activity on PYESwap. While time travel queries can be used for direct comparison against values in the past, it is much more expensive to query grouped data. For this reason the subgraph tracks information grouped in daily buckets, using timestamps provided by contract events. These entities can be used to query things like total volume on a given day, price of a token on a given day, etc.

For each DayData type, a new entity is created each day.

PYESwapDayData

Tracks data across all pairs aggregated into a daily bucket.

Field Name	Value Type	Description
id	ID	unix timestamp for start of day / 86400 giving a unique day index
date	Int	unix timestamp for start of day
dailyVolumeBNB	BigDecimal	total volume across all pairs on this day, stored as a derived amount of BNB
dailyVolumeUSD	BigDecimal	total volume across all pairs on this day, stored as a derived amount of USD
dailyVolumeUntracked	BigDecimal	​
totalVolumeBNB	BigDecimal	all time volume across all pairs in BNB up to and including this day
totalLiquidityBNB	BigDecimal	total liquidity across all pairs in BNB up to and including this day
totalVolumeUSD	BigDecimal	all time volume across all pairs in USD up to and including this day
totalLiquidityUSD	BigDecimal	total liquidity across all pairs in USD up to and including this day
totalTransactions	BigInt	number of transactions throughout this day

Pair Day Data

Tracks pair data across each day.

Field Name	Value Type	Description
id	ID	pair contract address and day id (day start timestamp in unix / 86400) concatenated with a dash
date	Int	unix timestamp for start of day
pairAddress	Bytes	address for pair contract
token0	Token	reference to token0
token1	Token	reference to token1
reserve0	BigDecimal	reserve of token0 (updated during each transaction on pair)
reserve1	BigDecimal	reserve of token1 (updated during each transaction on pair)
totalSupply	BigDecimal	total supply of liquidity token distributed to LPs
reserveUSD	BigDecimal	reserve of token0 plus token1 stored as a derived USD amount
dailyVolumeToken0	BigDecimal	total amount of token0 swapped throughout day
dailyVolumeToken1	BigDecimal	total amount of token1 swapped throughout day
dailyVolumeUSD	BigDecimal	total volume within pair throughout day
dailyTxns	BigInt	amount of transactions on pair throughout day

TokenDayData

Tracks token data aggregated across all pairs that include token.

Field Name	Value Type	Description
id	ID	token address and day id (day start timestamp in unix / 86400) concatenated with a dash
date	Int	unix timestamp for start of day
token	Token	reference to token entity
dailyVolumeToken	BigDecimal	amount of token swapped across all pairs throughout day
dailyVolumeBNB	BigDecimal	amount of token swapped across all pairs throughout day stored as a derived amount of BNB
dailyVolumeUSD	BigDecimal	amount of token swapped across all pairs throughout day stored as a derived amount of USD
dailyTxns	BigInt	amount of transactions with this token across all pairs
totalLiquidityToken	BigDecimal	token amount of token deposited across all pairs
totalLiquidityBNB	BigDecimal	token amount of token deposited across all pairs stored as amount of BNB
totalLiquidityUSD	BigDecimal	token amount of token deposited across all pairs stored as amount of USD
priceUSD	BigDecimal	price of token in derived USD