HomeDeveloper PortalFeedback & Roadmap
GuidesAPI Reference
HomeDeveloper PortalFeedback & RoadmapLog In

Glossary 📖

Wallet Tokens

Tokens held in wallet(s) supported by OpenPool and available for trading or other activities.

Staked/App Tokens

Tokens held in staking protocols or other DeFi apps supported by OpenPool.

Market Value

The amount of value you could receive for an asset at current market prices

API Attributes: value

Total Value Staked/In Apps

The current market value of tokens held in staking protocols and DeFi apps you’re active in. This value does not include staking or DeFi app income accruals.

API Attributes: total_value (/wallet/protocol_balance/)

Total Token Value

The sum of the current market value of your ERC-20 tokens held in wallet(s) and in DeFi app(s) supported by OpenPool. This value does not include DeFi app income accruals.

Wallet Tokens are ERC 20 tokens held in wallet(s) supported by OpenPool

Staked/App Tokens are ERC 20 tokens held in staking protocols or other DeFi apps supported by OpenPool

API Attributes: total_value

Total Floor Value

The Total Floor Value of the NFTs in your wallet(s) supported by OpenPool. An NFT’s Floor Price is the lowest price in that NFT’s collection.

  • OpenPool sources Floor Prices from OpenSea and LooksRare. If an NFT is listed on both OpenSea & Looksrare, OpenPool uses the lowest Floor Price available.

Note: If any NFT is listed on both OpenSea and LooksRare, OpenPool will use the lower Floor Price in this calculation

API Attributes: total_floor

Token FIFO Cost Basis

FIFO refers to the “first-in-first-out” accounting method. The FIFO method assigns the token’s cost basis based on when you purchased the particular token. FIFO assumes that in a realization event, the cost basis of the token(s) sold/swapped/sent is the price paid for the first token of that kind you bought. If your transaction includes multiple tokens (for example, 5 ETH), the FIFO method will calculate the cost basis for the transaction by looking back to the next “oldest” price paid for the token (ETH in this example) and assign cost basis chronologically from “oldest” to “newest” until all of the ETH in the transaction have been assigned a cost basis.

  • Cost Basis includes the gas fees paid for a given transaction.
  • Cost Basis methodology can be selected using the cost_method parameter

API Attributes: cost_method, basis

Token Weighted Average Cost Basis

An individual token’s Average Cost Basis is calculated using the Average Cost accounting method, which is the average purchase price at which you bought the token.

  • For example, if you bought one Ether at $1,000 and another Ether at $2,000, your Cost Basis for Ether overall would be $1,500 — the average of $1,000 and $2,000.
  • Cost Basis includes the gas fees paid for a given transaction.
  • Cost Basis methodology can be selected using the cost_method parameter

API Attributes: cost_method, basis

Token LIFO Cost Basis

LIFO refers to the “last-in-first-out” accounting method. LIFO is the opposite of FIFO and assumes that in a realization event, the cost basis of the token(s) sold/swapped/sent is the price paid for the most recent token of that kind purchased. If your transaction includes multiple tokens (for example, 7 MATIC), the LIFO method will calculate the cost basis for the transaction by looking back to the next “newest” price paid for the token (MATIC in this example) and assign cost basis chronologically from “newest” to “oldest” until all of the MATIC in the transaction have been assigned a cost basis.

  • Cost Basis includes the gas fees paid for a given transaction.
  • Cost Basis methodology can be selected using the cost_method parameter

API Attributes: cost_method, basis

Total Token Cost Basis

Your total token cost basis is the sum of the Cost Bases of the individual tokens in your wallet(s), including gas fees. Total Token Cost Basis excludes tokens held in staking or DeFi apps.

API Attributes: total_basis

Token Unrealized P&L

The total profit or loss you would hypothetically return and potentially pay taxes on, if you sold your Wallet Holdings at current token prices.

  • OpenPool accounts for wallet inflows and outflows in P&L calculations to show true returns.
  • Unrealized profit/loss is calculated based on the difference between the current market value and the Cost Basis of your Wallet Holdings — a token’s cost basis is can be calculated using FIFO, Average Cost, or LIFO.
  • An unrealized profit occurs when the Current Market Value of the token is greater than the Cost Basis for that same token.
  • An unrealized loss occurs when the Current Market Value is less than the token’s Cost Basis.
  • This calculation does not consider NFTs or any tokens currently staked or held in DeFi apps, nor does it consider DeFi app income accruals.
  • Cost Basis methodology can be selected using the cost_method parameter

Single Token:

Multiple Tokens:

API Attributes: total_unrealized_pnl

Token Realized P&L

Realization events generally follow the U.S. tax code. The profit or loss resulting from previous transactions where a Wallet Holding was sold, exchanged, swapped, or sent to a third-party during the time period selected. OpenPool accounts for wallet inflows and outflows in P&L calculations to show true returns.

  • A realized profit occurs if proceeds from the transaction(s) are greater than the token’s Cost Basis, while a realized loss occurs if proceeds are less than the token’s Cost Basis. (Cost Basis is calculated based on FIFO, Average Cost or LIFO accounting methods).
  • Remember that Swaps, Mints, Contract Executions, and Send transactions can all result in realized profits or losses if they require you to transfer tokens from your wallet(s), and may be subject to taxes according to the U.S. tax code.
  • This calculation does not consider NFTs or any tokens being staked or held in DeFi apps, nor does it consider DeFi app income accruals.
  • Cost Basis methodology can be selected using the cost_method parameter

Single Token:

Multiple Token:

Note: OpenPool assumes Swaps, Mints, Contract Executions, and Sends are all potential Realization Events where a Realized Gain or Loss can occur if there is a difference between the Realization Event Price and the Cost Basis

API Attributes: total_realized

Gas Fees

This is the total amount of network fees you’ve paid from your wallet(s) over the time period selected.

API Attributes: total_fees_usd, fee

Currency

For Accounting & Balance + Performance endpoints, you can choose which currency data is shown in. Options include US Dollar, ETH, MATIC, AVAX, or xDAI.

API Attributes: currency

Transfers

For a granular view of all transfers that occurred within a tx or that took place between your wallet/smart contract and a specified counterparty 0x address (trade partner address), use the Get Transfers endpoint.

API Attributes: wallet, counterparty_address, counterparty_name

Token Snapshot

Snapshot statistics consider your Wallet Holdings and tokens held in staking or other DeFi apps, excluding NFTs and DeFi app income accruals. Price Winner and Price Loser are calculated based on token price changes over the time period selected.

Unsupported Tokens

Unsupported tokens may not be widely traded and lack sufficient market data. They are excluded from any P&L calculation.

24 Hr Income Accrual

The income or rewards accumulated from DeFi app activities within the last 24 hours (only begins populating 24 hours after your wallet has been added to OpenPool).

API Attributes: total_24h_accrual

DeFi Strategy

This is the specific liquidity pool, staking, yield-farming, or other DeFi activity you are participating in.

API Attributes: strategy.name

Transaction Types

  • Mint - The act of publishing a new NFT on the blockchain. Mints typically occur through smart-contract executions.
  • Send - The act of transferring a digital asset from one wallet to another.
  • Receive - The act of taking possession of a digital asset in a wallet.
  • Swap - The act of trading a digital asset(s) for another digital asset(s). Swaps typically occur through smart-contract executions.
  • Contract Execution - Contract execution refers to transactions that occur through smart-contracts, other than Swaps and Mints. For example, approvals of ERC-20 tokens or protocol/DeFi-app participation.

API Attributes: category

NFT Cost Basis

Purchase price of the NFT, inclusive of gas fees paid at the time of minting.

  • Cost will be shown as “-” if you received the NFT without paying for it (for example, as an airdrop) or if you purchased the NFT “off-chain” (for example, on a centralized exchange).

API Attributes: cost_basis