> For the complete documentation index, see [llms.txt](https://docs.cielo.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cielo.finance/api-reference/models.md).

# Models

## The ErrorResponse object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"ErrorResponse":{"type":"object","description":"This object represents a response structure typically used to convey the outcome of a request. It primarily consists of a status indicator and a message, which together provide essential feedback about the request's processing. The status reflects the overall result of the request (such as success, error, etc.), while the message gives a more detailed explanation or the nature of the response, especially useful in cases of errors or exceptions.\n","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the response status object. This status is a key indicator of whether the request was processed successfully or resulted in an error."},"data":{"type":"object","description":"A flexible object intended to hold the actual data payload of the response. The structure of this object can vary depending on the specific endpoint and the nature of the response."},"message":{"type":"string","description":"A descriptive message providing additional details about the response. In case of an error, this message typically contains information useful for understanding the error's cause or nature."}},"required":["status","message"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]}}}}
```

## The Feed object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"Feed":{"type":"object","description":"The response schema for the /v1/feed endpoint.","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the standard response status object, which indicates the success or failure of the API request."},"data":{"type":"object","description":"Contains the main data of the response, including a list of transaction items and pagination details.","properties":{"items":{"type":"array","description":"An array of transaction items, each conforming to one of several types like Swap, LP, Transfer, Lending, etc. This array can contain a mix of these types.","items":{"oneOf":[{"$ref":"#/components/schemas/Swap"},{"$ref":"#/components/schemas/LP"},{"$ref":"#/components/schemas/Transfer"},{"$ref":"#/components/schemas/Lending"},{"$ref":"#/components/schemas/NftMint"},{"$ref":"#/components/schemas/NftTrade"},{"$ref":"#/components/schemas/NftTransfer"},{"$ref":"#/components/schemas/NftLending"},{"$ref":"#/components/schemas/Bridge"},{"$ref":"#/components/schemas/ContractInteraction"},{"$ref":"#/components/schemas/Wrap"},{"$ref":"#/components/schemas/SudoPool"},{"$ref":"#/components/schemas/Reward"},{"$ref":"#/components/schemas/Staking"},{"$ref":"#/components/schemas/Perp"},{"$ref":"#/components/schemas/Flashloan"},{"$ref":"#/components/schemas/ContractCreation"},{"$ref":"#/components/schemas/NftLiquidation"},{"$ref":"#/components/schemas/Option"},{"$ref":"#/components/schemas/NftSweep"}]}},"paging":{"type":"object","description":"Provides details about pagination, indicating the total number of rows on the current page, whether a next page exists, and the identifier for the next object.","properties":{"total_rows_in_page":{"type":"integer","minimum":0,"description":"The total number of rows present in the current page of the response."},"has_next_page":{"type":"boolean","description":"A boolean flag indicating if there is a subsequent page available after the current page."},"next_object":{"type":"string","description":"An identifier for the next object or page, used for pagination purposes."}},"required":["total_rows_in_page","has_next_page"]}},"required":["items","paging"]},"message":{"type":"string","description":"A descriptive message accompanying the response, often used to provide additional information or context about the results or the status of the request."}},"required":["status","data"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]},"Swap":{"type":"object","description":"This object type provides detailed information about a cryptocurrency swap transaction. It includes critical details such as wallet addresses, transaction hash, type of swap, blockchain specifics, and timestamps. The structure outlines the specifics of the assets involved in the swap, including their addresses, names, symbols, amounts, and USD values. It is particularly useful for platforms tracking and analyzing DeFi swap transactions, offering insights into the trade's details, such as the decentralized exchange (DEX) used, the tokens exchanged, and their respective values. This comprehensive structure is ideal for users or systems needing a detailed view of swap transactions on blockchain networks.\n","properties":{"wallet":{"type":"string","description":"The wallet address that initiated the swap transaction."},"wallet_label":{"type":"string","description":"A readable label for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the swap transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, a token swap."},"chain":{"type":"string","description":"The blockchain network where the swap transaction occurred."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"dex":{"type":"string","description":"The decentralized exchange where the swap transaction took place."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction (often the same as the 'from' address in swap transactions)."},"token0_address":{"type":"string","description":"The address of the first token involved in the swap."},"token0_amount":{"type":"number","format":"double","description":"The amount of the first token involved in the swap."},"token0_amount_usd":{"type":"number","format":"double","description":"The USD value of the first token amount at the time of the swap."},"token0_name":{"type":"string","description":"The name of the first token involved in the swap."},"token0_price_usd":{"type":"number","format":"double","description":"The price of the first token in USD."},"token0_symbol":{"type":"string","description":"The symbol of the first token involved in the swap."},"token0_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"token1_address":{"type":"string","description":"The address of the second token involved in the swap."},"token1_amount":{"type":"number","format":"double","description":"The amount of the second token involved in the swap."},"token1_amount_usd":{"type":"number","format":"double","description":"The USD value of the second token amount at the time of the swap."},"token1_name":{"type":"string","description":"The name of the second token involved in the swap."},"token1_price_usd":{"type":"number","format":"double","description":"The price of the second token in USD."},"token1_symbol":{"type":"string","description":"The symbol of the second token involved in the swap."},"token1_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"first_interaction":{"type":"boolean","description":"Indicates whether this transaction was the first interaction between the involved wallet addresses."},"token_market_cap":{"type":"object","description":"Contains the market capitalization and liquidity details of the tokens involved in the swap transaction.","properties":{"token_address":{"type":"string","description":"The address of the token."},"market_cap":{"type":"number","format":"double","description":"The market capitalization of the token."},"liquidity":{"type":"number","format":"double","description":"The liquidity of the token."}},"required":["token_address","market_cap","liquidity"]},"is_sell":{"type":"boolean","description":"Indicates whether the swap transaction was a sell order."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","dex","from","to","token0_address","token0_amount","token0_amount_usd","token0_name","token0_price_usd","token0_symbol","token0_icon_link","token1_address","token1_amount","token1_amount_usd","token1_name","token1_price_usd","token1_symbol","token1_icon_link","first_interaction","is_sell"]},"LP":{"type":"object","description":"This object provides a comprehensive overview of a liquidity pool (LP) transaction on a decentralized exchange (DEX). It includes details about the wallet involved, the transaction hash, type, and associated blockchain, as well as specific information about the assets involved in the transaction. This structure is particularly useful for platforms that track and analyze liquidity pool actions, such as adding or removing liquidity, offering insights into the specifics of each action, including the assets involved, their amounts in both the native token and USD value, and their respective prices in USD.\n","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"dex":{"type":"string","description":"The name of the decentralized exchange where the LP transaction occurred."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"type":{"type":"string","description":"Specifies the nature of the LP transaction, such as 'add' or 'remove'."},"token0_address":{"type":"string","description":"The address of the first token involved in the LP transaction."},"token0_amount":{"type":"number","format":"double","description":"The amount of the first token involved in the transaction."},"token0_amount_usd":{"type":"number","format":"double","description":"The USD value of the first token amount at the time of the transaction."},"token0_name":{"type":"string","description":"The name of the first token involved in the transaction."},"token0_price_usd":{"type":"number","format":"double","description":"The price of the first token in USD."},"token0_symbol":{"type":"string","description":"The symbol of the first token involved in the transaction."},"token0_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"token1_address":{"type":"string","description":"The address of the second token involved in the LP transaction."},"token1_amount":{"type":"number","format":"double","description":"The amount of the second token involved in the transaction."},"token1_amount_usd":{"type":"number","format":"double","description":"The USD value of the second token amount at the time of the transaction."},"token1_name":{"type":"string","description":"The name of the second token involved in the transaction."},"token1_price_usd":{"type":"number","format":"double","description":"The price of the second token in USD."},"token1_symbol":{"type":"string","description":"The symbol of the second token involved in the transaction."},"token1_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"lower_bound":{"type":"number","format":"double","description":"Indicates the lower bound of the price range for the LP position, relevant in certain types of liquidity pools."},"upper_bound":{"type":"number","format":"double","description":"Indicates the upper bound of the price range for the LP position, relevant in certain types of liquidity pools."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","dex","from","type","token0_address","token0_amount","token0_amount_usd","token0_name","token0_price_usd","token0_symbol","token0_icon_link","token1_address","token1_amount","token1_amount_usd","token1_name","token1_price_usd","token1_symbol","token1_icon_link","lower_bound","upper_bound"]},"Transfer":{"type":"object","description":"This object represents the details of a cryptocurrency transfer transaction. It includes essential information such as wallet addresses, transaction hash, type of transfer, blockchain details, and timestamps. The structure is particularly useful for tracking standard token transfers on blockchain networks, providing a comprehensive overview of the transaction, including the amount transferred in USD, the token's contract address, its name, and symbol. This detailed structure is ideal for users or systems requiring a thorough view of token transfer transactions, including the specifics of the token involved and the value of the transaction.\n","properties":{"wallet":{"type":"string","description":"The wallet address involved in the transfer transaction."},"wallet_label":{"type":"string","description":"A readable label for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the transfer transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, a token transfer."},"chain":{"type":"string","description":"The blockchain network where the transfer transaction occurred."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"from_label":{"type":"string","description":"A readable version of the 'from' wallet address."},"to_label":{"type":"string","description":"A readable version of the 'to' wallet address."},"amount_usd":{"type":"number","format":"double","description":"The USD value of the amount transferred in the transaction."},"contract_address":{"type":"string","description":"The blockchain address of the contract under which the token is registered."},"name":{"type":"string","description":"The name of the token being transferred."},"symbol":{"type":"string","description":"The symbol of the token being transferred."},"token_price_usd":{"type":"number","format":"double","description":"The price of the token in USD at the time of the transaction."},"type":{"type":"string","description":"Indicates the contract standard of the token, such as ERC20."},"token_icon_link":{"type":"string","description":"A URL link to the token's icon image."},"token_market_cap":{"type":"object","description":"Contains the market capitalization and liquidity details of the tokens involved in the swap transaction.","properties":{"token_address":{"type":"string","description":"The address of the token."},"market_cap":{"type":"number","format":"double","description":"The market capitalization of the token."},"liquidity":{"type":"number","format":"double","description":"The liquidity of the token."}},"required":["token_address","market_cap","liquidity"]},"mempool":{"type":"boolean","description":"For Bitcoin transactions, this field indicates whether the transaction is in the mempool."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","from_label","to_label","amount_usd","contract_address","name","symbol","token_price_usd","type","token_icon_link"]},"Lending":{"type":"object","description":"This object represents the data structure for a specific transaction related to decentralized finance (DeFi) activities such as lending, borrowing, and other related actions. It provides detailed information about the transaction, including wallet addresses, transaction hash, type of transaction, chain details, and financial figures. This structure is particularly useful for platforms tracking DeFi activities, offering insights into the specifics of each transaction, such as the asset involved, the amount, the health factor in lending platforms, and the price of the asset in USD at the time of the transaction.\n","properties":{"wallet":{"type":"string","description":"The wallet address associated with the transaction."},"wallet_label":{"type":"string","description":"A more readable, shortened version of the wallet address."},"tx_hash":{"type":"string","description":"The unique identifier of the transaction, represented as a hash."},"tx_type":{"type":"string","description":"Specifies the type of DeFi transaction, such as lending, borrowing, etc."},"chain":{"type":"string","description":"Indicates the blockchain network on which the transaction occurred."},"index":{"type":"integer","description":"A sequential index or identifier for the transaction within a particular dataset or list."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number in the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"from_label":{"type":"string","description":"A readable, abbreviated form of the 'from' wallet address."},"action":{"type":"string","description":"Describes the action taken in the transaction, such as 'Repaid' in a lending scenario."},"address":{"type":"string","description":"The smart contract address involved in the transaction."},"amount":{"type":"number","format":"double","description":"The amount of the asset involved in the transaction."},"amount_usd":{"type":"number","format":"double","description":"The equivalent value of the transaction amount in USD."},"dex":{"type":"string","description":"The decentralized exchange or platform where the transaction occurred, such as AaveV2."},"health_factor":{"type":"number","format":"double","description":"A metric specific to lending platforms, indicating the health of the loan or position."},"name":{"type":"string","description":"The name of the asset involved in the transaction."},"platform":{"type":"string","description":"The DeFi platform associated with the transaction, like AaveV3."},"price_usd":{"type":"number","format":"double","description":"The price of the asset in USD at the time of the transaction."},"symbol":{"type":"string","description":"The symbol of the asset involved in the transaction."},"token_icon_link":{"type":"string","description":"A URL link to the icon image of the token involved in the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","from_label","action","address","amount","amount_usd","dex","health_factor","name","platform","price_usd","symbol","token_icon_link"]},"NftMint":{"type":"object","description":"This object represents the data structure for a Non-Fungible Token (NFT) minting transaction. It provides detailed information about the transaction, including wallet addresses, transaction hash, the type of NFT transaction (in this case, minting), and blockchain specifics. Additionally, it includes detailed information about the NFT minted, such as its image, contract address, token ID, and associated fees. This structure is particularly useful for platforms tracking NFT minting activities, offering insights into the creation of new NFTs, their associated costs, and the blockchain details.\n","properties":{"wallet":{"type":"string","description":"The wallet address involved in the NFT minting transaction."},"wallet_label":{"type":"string","description":"A more readable label or identifier for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the NFT minting transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, NFT minting."},"chain":{"type":"string","description":"The blockchain network on which the minting transaction was conducted."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"from_label":{"type":"string","description":"A readable version of the 'from' wallet address."},"to_label":{"type":"string","description":"A readable version of the 'to' wallet address."},"thumbnail":{"type":"string","description":"A thumbnail image URL of the NFT involved in the transaction."},"image":{"type":"string","description":"A full image URL of the NFT."},"amount":{"type":"number","format":"double","description":"The number of items of the NFT minted in the transaction."},"contract_address":{"type":"string","description":"The blockchain address of the contract under which the NFT is minted."},"contract_type":{"type":"string","description":"The type of contract used for the NFT, such as ERC721."},"fee":{"type":"number","format":"double","description":"The transaction fee incurred for minting the NFT."},"nft_name":{"type":"string","description":"The name of the NFT minted."},"nft_symbol":{"type":"string","description":"The symbol associated with the NFT."},"nft_token_id":{"type":"string","description":"The unique token ID of the minted NFT."},"currency_symbol":{"type":"string","description":"The symbol of the currency used in the transaction (e.g., ETH, MATIC)."},"type":{"type":"string","description":"Indicates the contract standard of the NFT, such as ERC721."},"value":{"type":"number","format":"double","description":"The value of the transaction. For minting, this is often zero since the NFT is being created."},"value_usd":{"type":"number","format":"double","description":"The equivalent USD value of the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","from_label","to_label","thumbnail","image","amount","contract_address","contract_type","fee","nft_name","nft_symbol","nft_token_id","currency_symbol","type","value","value_usd"]},"NftTrade":{"type":"object","description":"This object encapsulates the details of a Non-Fungible Token (NFT) trading transaction. It includes comprehensive information such as wallet addresses, transaction hash, type of transaction (NFT trade), blockchain details, and timestamps. The structure provides specific data about the NFT trade, including the NFT's image, contract address, marketplace of the trade, and price details in both cryptocurrency and USD. Additionally, it includes information about the buyer, seller, and whether the transaction involved a bid being accepted. This structure is ideal for platforms that monitor and analyze NFT trading activities, offering detailed insights into each trade, its valuation, and the parties involved.\n","properties":{"wallet":{"type":"string","description":"The wallet address involved in the NFT trading transaction."},"wallet_label":{"type":"string","description":"A readable label for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the NFT trading transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, NFT trading."},"chain":{"type":"string","description":"The blockchain network where the trading transaction occurred."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"thumbnail":{"type":"string","description":"A thumbnail image URL of the NFT involved in the transaction."},"image":{"type":"string","description":"A full image URL of the NFT."},"action":{"type":"string","description":"Describes the action taken in the NFT trade, such as 'buy' or 'sell'."},"contract":{"type":"string","description":"The blockchain contract address associated with the NFT."},"marketplace":{"type":"string","description":"The marketplace where the NFT trade occurred, such as OpenSea."},"nft_address":{"type":"string","description":"The blockchain address of the NFT involved in the trade."},"nft_name":{"type":"string","description":"The name of the NFT traded."},"nft_symbol":{"type":"string","description":"The symbol associated with the NFT."},"nft_token_id":{"type":"string","description":"The unique token ID of the NFT involved in the trade."},"price":{"type":"number","format":"double","description":"The price at which the NFT was traded."},"price_usd":{"type":"number","format":"double","description":"The equivalent USD value of the NFT trade."},"profit":{"type":"number","format":"double","description":"The profit earned from the trade. This may be zero in some transactions."},"currency_symbol":{"type":"string","description":"The symbol of the currency used in the trade, such as WETH or ETH."},"buyer":{"type":"string","description":"The wallet address of the buyer in the trade."},"seller":{"type":"string","description":"The wallet address of the seller in the trade."},"token":{"type":"string","description":"The token type used in the transaction."},"first_interaction":{"type":"boolean","description":"Indicates whether this was the first interaction between the buyer and seller."},"bid_accepted":{"type":"boolean","description":"Specifies if the transaction involved a bid being accepted."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","thumbnail","image","action","contract","marketplace","nft_address","nft_name","nft_symbol","nft_token_id","price","price_usd","profit","currency_symbol","buyer","seller","token","first_interaction","bid_accepted"]},"NftTransfer":{"type":"object","description":"This object type details a Non-Fungible Token (NFT) transfer transaction. It includes essential information such as wallet addresses, transaction hash, NFT details, and blockchain specifics. This structure is particularly useful for tracking NFT transfers, providing a complete overview of the transaction, including the involved parties (from and to addresses), the NFT's contract details, and the transaction's metadata such as timestamps and blockchain network. The object also includes the NFT's image, name, symbol, and token ID, offering a comprehensive view of the NFT being transferred.\n","properties":{"wallet":{"type":"string","description":"The wallet address involved in the NFT transfer transaction."},"wallet_label":{"type":"string","description":"A readable label for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the NFT transfer transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, NFT transfer."},"chain":{"type":"string","description":"The blockchain network where the transfer transaction occurred."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"from_label":{"type":"string","description":"A readable version of the 'from' wallet address."},"to_label":{"type":"string","description":"A readable version of the 'to' wallet address."},"thumbnail":{"type":"string","description":"A thumbnail image URL of the NFT involved in the transaction."},"image":{"type":"string","description":"A full image URL of the NFT."},"contract_address":{"type":"string","description":"The blockchain address of the contract under which the NFT is registered."},"contract_type":{"type":"string","description":"The type of contract used for the NFT, such as ERC721."},"fee":{"type":"number","format":"double","description":"The transaction fee incurred for the transfer of the NFT."},"nft_name":{"type":"string","description":"The name of the NFT being transferred."},"nft_symbol":{"type":"string","description":"The symbol associated with the NFT."},"nft_token_id":{"type":"string","description":"The unique token ID of the NFT involved in the transfer."},"type":{"type":"string","description":"Indicates the contract standard of the NFT, such as ERC721."},"value":{"type":"number","format":"double","description":"The value of the NFT at the time of the transfer. This might be represented in the native cryptocurrency of the blockchain."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","from_label","to_label","thumbnail","image","contract_address","contract_type","fee","nft_name","nft_symbol","nft_token_id","type","value"]},"NftLending":{"type":"object","description":"This object encapsulates detailed information about a Non-Fungible Token (NFT) lending transaction. It includes comprehensive details such as wallet addresses, transaction hash, the type of NFT transaction, the blockchain used, and timestamps. Additionally, it provides specifics about the NFT involved, including its address, name, symbol, image, and the terms of the lending agreement. This structure is particularly useful for platforms that need to track and manage NFT lending activities, providing all necessary details for analyzing and processing such transactions.\n","properties":{"wallet":{"type":"string","description":"The wallet address involved in the NFT lending transaction."},"wallet_label":{"type":"string","description":"A more readable label or identifier for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the NFT lending transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, NFT lending."},"chain":{"type":"string","description":"The blockchain network on which the transaction was conducted."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"from_label":{"type":"string","description":"A readable version of the 'from' wallet address."},"to_label":{"type":"string","description":"A readable version of the 'to' wallet address."},"thumbnail":{"type":"string","description":"A thumbnail image URL of the NFT involved in the transaction."},"image":{"type":"string","description":"A full image URL of the NFT."},"action":{"type":"string","description":"Describes the action taken in the NFT lending transaction, such as 'buy', 'lend', etc."},"currency_address":{"type":"string","description":"The blockchain address of the currency used in the transaction."},"currency_symbol":{"type":"string","description":"The symbol of the currency used in the transaction."},"interest":{"type":"number","format":"double","description":"The interest rate applied in the NFT lending transaction."},"nft_address":{"type":"string","description":"The blockchain address of the NFT involved in the transaction."},"nft_name":{"type":"string","description":"The name of the NFT."},"nft_symbol":{"type":"string","description":"The symbol of the NFT."},"platform":{"type":"string","description":"The platform or service through which the NFT lending transaction was conducted."},"nft_token_id":{"type":"string","description":"The unique identifier for the specific NFT within its collection."},"price":{"type":"number","format":"double","description":"The price at which the NFT was lent or transacted."},"price_usd":{"type":"number","format":"double","description":"The equivalent USD value of the transaction price."},"terms":{"type":"number","format":"double","description":"Specifies the terms of the NFT lending agreement."},"refinance":{"type":"boolean","description":"Indicates whether the transaction involved refinancing of the NFT."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","from_label","to_label","thumbnail","image","action","currency_address","currency_symbol","interest","nft_address","nft_name","nft_symbol","platform","nft_token_id","price","price_usd","terms","refinance"]},"Bridge":{"type":"object","description":"This object represents a detailed structure for a blockchain transaction, encompassing various aspects like wallet addresses, transaction hash, type, associated chains, and financial details. It is designed to provide a comprehensive view of a transaction, including the wallets involved, the transaction's nature, the chains it spans, and the financial details like the amount and its equivalent in USD. This structure is ideal for applications that require detailed tracking and analysis of blockchain transactions.\n","properties":{"wallet":{"type":"string","description":"The wallet address involved in the transaction."},"wallet_label":{"type":"string","description":"A shortened, more readable version of the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the transaction."},"tx_type":{"type":"string","description":"The type of transaction."},"chain":{"type":"string","description":"The blockchain on which the transaction occurred, like 'ethereum'."},"index":{"type":"integer","description":"A numeric index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp when the transaction occurred."},"block":{"type":"integer","description":"The block number on the blockchain in which the transaction is included."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"from_label":{"type":"string","description":"A shortened, more readable version of the originating wallet address."},"to_label":{"type":"string","description":"A shortened, more readable version of the destination wallet address."},"token_address":{"type":"string","description":"The address of the token involved in the transaction."},"token_name":{"type":"string","description":"The name of the token involved in the transaction."},"token_symbol":{"type":"string","description":"The symbol of the token involved in the transaction."},"token_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"amount":{"type":"number","format":"double","description":"The amount of the token involved in the transaction."},"amount_usd":{"type":"number","format":"double","description":"The equivalent amount in USD of the tokens involved in the transaction."},"from_chain":{"type":"string","description":"The originating chain of the transaction, in cases of cross-chain activities."},"to_chain":{"type":"string","description":"The destination chain of the transaction, in cases of cross-chain activities."},"platform":{"type":"string","description":"The platform or service used for the transaction."},"price":{"type":"number","format":"double","description":"The price of the token at the time of the transaction."},"type":{"type":"string","description":"Specifies the nature of the transaction, like 'withdraw', 'deposit', etc."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","from_label","to_label","token_address","token_name","token_symbol","amount","amount_usd","from_chain","to_chain","platform","price","type","token_icon_link"]},"ContractInteraction":{"type":"object","description":"This object provides a structure for representing a contract interaction event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"contract_address":{"type":"string","description":"The address of the smart contract involved in the interaction."},"contract_label":{"type":"string","description":"A human-readable label or name associated with the smart contract."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","contract_address","contract_label"]},"Wrap":{"type":"object","description":"This object provides a structure for representing a wrap event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"dex":{"type":"string","description":"The decentralized exchange where the wrap transaction occurred."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"action":{"type":"string"},"amount":{"type":"number","description":"The amount of tokens wrapped in the transaction."},"amount_usd":{"type":"number","description":"The equivalent amount in USD of the wrapped tokens."},"contract_address":{"type":"string","description":"The address of the smart contract involved in the interaction."},"name":{"type":"string","description":"The name of the token wrapped in the transaction."},"symbol":{"type":"string","description":"The symbol of the token wrapped in the transaction."},"token_price_usd":{"type":"number","description":"The price of the token in USD at the time of the transaction."},"token_type":{"type":"string","description":"The type of token wrapped in the transaction."},"token_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","dex","from","to","action","amount","amount_usd","contract_address","name","symbol","token_price_usd","token_type","token_icon_link"]},"SudoPool":{"type":"object","description":"This object provides a structure for representing a Sudo Pool event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"dex":{"type":"string","description":"The decentralized exchange where the wrap transaction occurred."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"nft_address":{"type":"string","description":"The address of the NFT contract involved in the interaction."},"nft_amount":{"type":"integer","description":"The amount of NFTs involved in the transaction."},"nft_price":{"type":"number","description":"The price of the NFT in the transaction."},"nft_symbol":{"type":"string","description":"The symbol of the NFT in the transaction."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"token0_address":{"type":"string","description":"The address of the first token in the LP pair."},"token0_amount":{"type":"number","description":"The amount of the first token in the LP pair."},"token0_amount_usd":{"type":"number","description":"The equivalent amount in USD of the first token in the LP pair."},"token0_name":{"type":"string","description":"The name of the first token in the LP pair."},"token0_price_usd":{"type":"number","description":"The price of the first token in the LP pair in USD."},"token0_symbol":{"type":"string","description":"The symbol of the first token in the LP pair."},"token0_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","nft_address","nft_amount","nft_price","nft_symbol","token0_address","token0_amount","token0_amount_usd","token0_name","token0_price_usd","token0_symbol","from","to","token0_icon_link"]},"Reward":{"type":"object","description":"This object provides a structure for representing a reward event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"address":{"type":"string","description":"The address of the token involved in the transaction."},"amount":{"type":"number","description":"The amount of tokens involved in the transaction."},"amount_usd":{"type":"number","description":"The equivalent amount in USD of the tokens involved in the transaction."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"name":{"type":"string","description":"The name of the token involved in the transaction."},"price_usd":{"type":"number","description":"The price of the token in USD."},"symbol":{"type":"string","description":"The symbol of the token involved in the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","address","amount","amount_usd","from","name","price_usd","symbol"]},"Staking":{"type":"object","description":"This object provides a structure for representing a staking event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"from_label":{"type":"string","description":"A human-readable label or name associated with the originating wallet."},"to_label":{"type":"string","description":"A human-readable label or name associated with the destination wallet."},"amount":{"type":"number","description":"The amount of tokens staked in the transaction."},"amount_usd":{"type":"number","description":"The equivalent amount in USD of the staked tokens."},"token_price_usd":{"type":"number","description":"The price of the token in USD."},"contract_address":{"type":"string","description":"The address of the smart contract involved in the interaction."},"symbol":{"type":"string","description":"The symbol of the token staked in the transaction."},"name":{"type":"string","description":"The name of the token staked in the transaction."},"action":{"type":"string","description":"The action taken in the staking transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","from_label","to_label","amount","amount_usd","token_price_usd","contract_address","symbol","name","action"]},"Perp":{"type":"object","description":"This object provides a structure for representing a Perpetual event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"action":{"type":"string","description":"The action taken in the Perpetual event."},"amount_usd":{"type":"number","description":"The equivalent amount in USD of the tokens involved in the transaction."},"average_price":{"type":"number","description":"The average price of the tokens involved in the transaction."},"base_token_address":{"type":"string","description":"The address of the base token involved in the transaction."},"base_token_amount":{"type":"number","description":"The amount of base tokens involved in the transaction."},"base_token_symbol":{"type":"string","description":"The symbol of the base token involved in the transaction."},"dex":{"type":"string","description":"The decentralized exchange where the Perpetual transaction occurred."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"liquidation":{"type":"boolean","description":"Indicates whether the transaction was a liquidation."},"liquidation_price":{"type":"number","description":"The price at which the liquidation occurred."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"trade_direction":{"type":"string","description":"The direction of the trade in the Perpetual transaction."},"perp_details":{"type":"string","description":"Additional details about the Perpetual transaction."},"token0_address":{"type":"string","description":"The address of the first token in the LP pair."},"token0_amount":{"type":"number","description":"The amount of the first token in the LP pair."},"token0_amount_usd":{"type":"number","description":"The equivalent amount in USD of the first token in the LP pair."},"token0_name":{"type":"string","description":"The name of the first token in the LP pair."},"token0_price_usd":{"type":"number","description":"The price of the first token in the LP pair in USD."},"token0_symbol":{"type":"string","description":"The symbol of the first token in the LP pair."},"token0_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"token1_address":{"type":"string","description":"The address of the second token in the LP pair."},"token1_amount":{"type":"number","description":"The amount of the second token in the LP pair."},"token1_amount_usd":{"type":"number","description":"The equivalent amount in USD of the second token in the LP pair."},"token1_name":{"type":"string","description":"The name of the second token in the LP pair."},"token1_price_usd":{"type":"number","description":"The price of the second token in the LP pair in USD."},"token1_symbol":{"type":"string","description":"The symbol of the second token in the LP pair."},"token1_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"realized_pnl":{"type":"number","description":"The realized profit and loss of the Perpetual transaction."},"is_nft_perp":{"type":"boolean","description":"Indicates whether the Perpetual transaction involves an NFT."},"position_size":{"type":"number","description":"The size of the position in the Perpetual transaction."},"position_size_usd":{"type":"number","description":"The equivalent amount in USD of the position size."},"leverage":{"type":"number","description":"The leverage used in the Perpetual transaction."},"unrealized_pnl":{"type":"number","description":"The unrealized profit and loss of the Perpetual transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","action","amount_usd","average_price","base_token_address","base_token_amount","base_token_symbol","dex","from","liquidation","liquidation_price","to","trade_direction","perp_details","token0_address","token0_amount","token0_amount_usd","token0_name","token0_price_usd","token0_symbol","token0_icon_link","token1_address","token1_amount","token1_amount_usd","token1_name","token1_price_usd","token1_symbol","token1_icon_link","realized_pnl","is_nft_perp"]},"Flashloan":{"type":"object","description":"This object provides a structure for representing a flashloan event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"address":{"type":"string","description":"The address of the token involved in the transaction."},"amount":{"type":"number","description":"The amount of tokens involved in the transaction."},"amount_usd":{"type":"number","description":"The equivalent amount in USD of the tokens involved in the transaction."},"dex":{"type":"string","description":"The decentralized exchange (DEX) where the flashloan transaction took place."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"health_factor":{"type":"number","description":"The health factor of the wallet after the flashloan transaction."},"name":{"type":"string","description":"The name of the token involved in the transaction."},"platform":{"type":"string","description":"The platform where the flashloan transaction took place."},"price_usd":{"type":"number","description":"The price of the token in USD."},"symbol":{"type":"string","description":"The symbol of the token involved in the transaction."},"token_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","address","amount","amount_usd","dex","from","health_factor","name","platform","price_usd","symbol","token_icon_link"]},"ContractCreation":{"type":"object","description":"This object provides a structure for representing a contract creation event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"amount_usd":{"type":"number","description":"The equivalent amount in USD of the wrapped tokens."},"contract_address":{"type":"string","description":"The address of the smart contract involved in the interaction."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"from_label":{"type":"string","description":"A human-readable label or name associated with the originating wallet."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","amount_usd","contract_address","from","from_label"]},"NftLiquidation":{"type":"object","description":"This object provides a structure for representing a NFT liquidation event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"contract_address":{"type":"string","description":"The address of the NFT contract involved in the interaction."},"currency_address":{"type":"string","description":"The address of the currency involved in the transaction."},"currency_symbol":{"type":"string","description":"The symbol of the currency involved in the transaction."},"dex":{"type":"string","description":"The decentralized exchange where the wrap transaction occurred."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"nft_address":{"type":"string","description":"The address of the NFT contract involved in the interaction."},"nft_name":{"type":"string","description":"The name of the NFT in the transaction."},"nft_symbol":{"type":"string","description":"The symbol of the NFT in the transaction."},"platform":{"type":"string","description":"The platform where the flashloan transaction took place."},"price":{"type":"number","description":"The price of the NFT in the transaction."},"price_usd":{"type":"number","description":"The price of the NFT in USD."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"token_id":{"type":"string","description":"The unique identifier of the NFT in the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","contract_address","currency_address","currency_symbol","dex","from","nft_address","nft_name","nft_symbol","platform","price","price_usd","to","token_id"]},"Option":{"type":"object","description":"This object provides a structure for representing an option event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"action":{"type":"string","description":"The action taken in the option event."},"amount":{"type":"number","description":"The amount of tokens involved in the transaction."},"asset":{"type":"string","description":"The asset involved in the option event."},"dex":{"type":"string","description":"The decentralized exchange (DEX) where the option event took place."},"direction":{"type":"string","description":"The direction of the option event."},"expiry":{"type":"string","description":"The expiry date of the option."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"option_price_usd":{"type":"number","description":"The price of the option in USD."},"position_status":{"type":"string","description":"The status of the option position."},"spot_price_usd":{"type":"number","description":"The spot price of the asset in USD."},"status":{"type":"string","description":"The status of the option event."},"strike_price_usd":{"type":"number","description":"The strike price of the option in USD."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"type":{"type":"string","description":"The type of option event."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","action","amount","asset","dex","direction","expiry","from","option_price_usd","position_status","spot_price_usd","status","strike_price_usd","to","type"]},"NftSweep":{"type":"object","description":"This object provides a structure for representing a NFT sweep event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address involved in the NFT trading transaction."},"wallet_label":{"type":"string","description":"A readable label for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the NFT trading transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, NFT trading."},"chain":{"type":"string","description":"The blockchain network where the trading transaction occurred."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"thumbnail":{"type":"string","description":"A thumbnail image URL of the NFT involved in the transaction."},"image":{"type":"string","description":"A full image URL of the NFT."},"action":{"type":"string","description":"Describes the action taken in the NFT trade, such as 'buy' or 'sell'."},"contract":{"type":"string","description":"The blockchain contract address associated with the NFT."},"marketplace":{"type":"string","description":"The marketplace where the NFT trade occurred, such as OpenSea."},"nft_address":{"type":"string","description":"The blockchain address of the NFT involved in the trade."},"nft_name":{"type":"string","description":"The name of the NFT traded."},"nft_symbol":{"type":"string","description":"The symbol associated with the NFT."},"nft_token_id":{"type":"string","description":"The unique token ID of the NFT involved in the trade."},"price":{"type":"number","format":"double","description":"The price at which the NFT was traded."},"price_usd":{"type":"number","format":"double","description":"The equivalent USD value of the NFT trade."},"profit":{"type":"number","format":"double","description":"The profit earned from the trade. This may be zero in some transactions."},"currency_symbol":{"type":"string","description":"The symbol of the currency used in the trade, such as WETH or ETH."},"buyer":{"type":"string","description":"The wallet address of the buyer in the trade."},"seller":{"type":"string","description":"The wallet address of the seller in the trade."},"token":{"type":"string","description":"The token type used in the transaction."},"first_interaction":{"type":"boolean","description":"Indicates whether this was the first interaction between the buyer and seller."},"bid_accepted":{"type":"boolean","description":"Specifies if the transaction involved a bid being accepted."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","thumbnail","image","action","contract","marketplace","nft_address","nft_name","nft_symbol","nft_token_id","price","price_usd","profit","currency_symbol","buyer","seller","token","first_interaction","bid_accepted"]}}}}
```

## The TotalStats object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"TotalStats":{"type":"object","description":"The response schema for the /v1/{wallet}/pnl/total-stats endpoint.","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the standard response status object, which indicates the success or failure of the API request."},"data":{"type":"object","description":"Contains the main data of the response, including aggregated PnL stats for the specified wallet.","properties":{"wallet":{"type":"string","description":"The wallet address for which the PnL stats are provided."},"realized_pnl_usd":{"type":"number","format":"float64","description":"The total PnL in usd for the specified wallet."},"realized_roi_percentage":{"type":"number","format":"float64","description":"The total ROI percentage for the specified wallet."},"tokens_traded":{"type":"integer","description":"The total number of tokens traded for the specified wallet."},"unrealized_pnl_usd":{"type":"number","format":"float64","description":"The total unrealized PnL in usd for the specified wallet."},"unrealized_roi_percentage":{"type":"number","format":"float64","description":"The total unrealized ROI percentage for the specified wallet."},"winrate":{"type":"number","format":"float64","description":"The winrate percentage for the specified wallet."},"average_holding_time":{"type":"integer","format":"float64","description":"The average holding time for the specified wallet in hours.","deprecated":true},"average_holding_time_seconds":{"type":"integer","description":"The average holding time for the specified wallet in seconds."},"median_holding_time_seconds":{"type":"integer","description":"The median holding time for the specified wallet in seconds."},"combined_pnl_usd":{"type":"number","format":"float64","description":"The combined PnL in usd for the specified wallet."},"combined_roi_percentage":{"type":"number","format":"float64","description":"The combined ROI percentage for the specified wallet."},"total_buy_usd":{"type":"number","format":"float64","description":"The total buy amount in usd for the specified wallet."},"total_sell_usd":{"type":"number","format":"float64","description":"The total sell amount in usd for the specified wallet."}}},"message":{"type":"string","description":"A descriptive message accompanying the response, often used to provide additional information or context about the results or the status of the request."}},"required":["status","data"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]}}}}
```

## The TagTypes object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"TagTypes":{"type":"string","enum":["high_volume_dex_trader","early_defi","multichain","new_wallet","high_leverage_trader","nft_trader","nftfi","nft_high_pnl","popular_wallet","airdrop_hunter","gem_finder","high_win_rate","new_whale","flipper","honeypot","mev","sniper"]}}}}
```

## The TagModel object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"TagModel":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/TagTypes","description":"A unique identifier for the tag."},"tag":{"type":"string","description":"The tag label or name."},"description":{"type":"string","description":"A description of what the tag represents."}},"required":["key","tag","description"]},"TagTypes":{"type":"string","enum":["high_volume_dex_trader","early_defi","multichain","new_wallet","high_leverage_trader","nft_trader","nftfi","nft_high_pnl","popular_wallet","airdrop_hunter","gem_finder","high_win_rate","new_whale","flipper","honeypot","mev","sniper"]}}}}
```

## The Tags object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"Tags":{"type":"object","description":"The response schema for the /v1/{wallet}/tags endpoint.","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the standard response status object, which indicates the success or failure of the API request."},"data":{"type":"object","description":"Contains the main data of the response.","properties":{"tags":{"type":"array","description":"An array of tags associated with the wallet address.","items":{"$ref":"#/components/schemas/TagModel"}}}},"message":{"type":"string","description":"A descriptive message accompanying the response, often used to provide additional information or context about the results or the status of the request."}},"required":["status","data"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]},"TagModel":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/TagTypes","description":"A unique identifier for the tag."},"tag":{"type":"string","description":"The tag label or name."},"description":{"type":"string","description":"A description of what the tag represents."}},"required":["key","tag","description"]},"TagTypes":{"type":"string","enum":["high_volume_dex_trader","early_defi","multichain","new_wallet","high_leverage_trader","nft_trader","nftfi","nft_high_pnl","popular_wallet","airdrop_hunter","gem_finder","high_win_rate","new_whale","flipper","honeypot","mev","sniper"]}}}}
```

## The WalletsTags object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"WalletsTags":{"type":"object","description":"The response schema for the /v1/tags endpoint.","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the standard response status object, which indicates the success or failure of the API request."},"data":{"type":"array","description":"Contains the main data of the response.","items":{"type":"object","properties":{"wallet":{"type":"string","description":"The wallet address associated with the tags."},"tags":{"$ref":"#/components/schemas/TagModel"}}}},"message":{"type":"string","description":"A descriptive message accompanying the response, often used to provide additional information or context about the results or the status of the request."}},"required":["status","data"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]},"TagModel":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/TagTypes","description":"A unique identifier for the tag."},"tag":{"type":"string","description":"The tag label or name."},"description":{"type":"string","description":"A description of what the tag represents."}},"required":["key","tag","description"]},"TagTypes":{"type":"string","enum":["high_volume_dex_trader","early_defi","multichain","new_wallet","high_leverage_trader","nft_trader","nftfi","nft_high_pnl","popular_wallet","airdrop_hunter","gem_finder","high_win_rate","new_whale","flipper","honeypot","mev","sniper"]}}}}
```

## The WalletsByTag object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"WalletsByTag":{"type":"object","description":"The response schema for the /v1/tags/wallets endpoint.","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the standard response status object, which indicates the success or failure of the API request."},"data":{"type":"object","description":"Contains the main data of the response.","properties":{"items":{"type":"array","description":"An array of related wallets associated with the wallet address.","items":{"type":"object","properties":{"wallet":{"type":"string","description":"The wallet address for a wallet with the provided tags."},"wallet_type":{"type":"string","enum":["evm","solana"],"description":"The wallet type for the wallet returned."}}}},"paging":{"type":"object","description":"Provides details about pagination, indicating the total number of rows on the current page, whether a next page exists, and the identifier for the next object.","properties":{"next_page":{"type":"string","description":"An identifier for the next page, used for pagination purposes."},"has_next_page":{"type":"boolean","description":"Indicates whether a next page exists."}},"required":["has_next_page"]}},"required":["items","paging"]},"message":{"type":"string","description":"A descriptive message accompanying the response, often used to provide additional information or context about the results or the status of the request."}},"required":["status","data"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]}}}}
```

## The RelatedWallets object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"RelatedWallets":{"type":"object","description":"The response schema for the /v1/{wallet}/related-wallets endpoint.","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the standard response status object, which indicates the success or failure of the API request."},"data":{"type":"object","description":"Contains the main data of the response.","properties":{"related_wallets":{"type":"array","description":"An array of related wallets associated with the wallet address.","items":{"type":"object","properties":{"wallet":{"type":"string","description":"The wallet address for which the related wallets are provided."},"inflow_usd":{"type":"integer","description":"The total inflow in usd for the specified wallet."},"outflow_usd":{"type":"integer","description":"The total outflow in usd for the specified wallet."},"total_usd":{"type":"integer","description":"The total inflow and outflow in usd for the specified wallet."},"count":{"type":"integer","description":"The total number of transactions for the specified wallet."},"label":{"type":"string","description":"The label for the related wallet."}}}}}},"message":{"type":"string","description":"A descriptive message accompanying the response, often used to provide additional information or context about the results or the status of the request."}},"required":["status","data"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]}}}}
```

## The TokenBalanceResponse object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"TokenBalanceResponse":{"type":"object","description":"Response containing token balance information","properties":{"chain":{"type":"string","description":"The chain of the token."},"token_address":{"type":"string","description":"The token address."},"token_name":{"type":"string","description":"The token name."},"token_symbol":{"type":"string","description":"The token symbol."},"token_price_usd":{"type":"number","description":"The token price in USD."},"balance":{"type":"number","description":"The token balance."},"total_usd_value":{"type":"number","description":"The total USD value."},"decimals":{"type":"integer","description":"The number of decimals for the token."}},"required":["chain","token_address","token_name","token_symbol","token_price_usd","balance","total_usd_value","decimals"]}}}}
```

## The WalletTypes object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"WalletTypes":{"type":"object","description":"Enumerates the different types of wallets.","enum":["unknown","evm","solana","dydx","bitcoin"]}}}}
```

## The GetWalletByAddress object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"GetWalletByAddress":{"type":"object","description":"The response schema for the /api/v1/tracked-wallets/address/{wallet} endpoint.","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the standard response status object, which indicates the success or failure of the API request."},"data":{"$ref":"#/components/schemas/TrackedWallet"}},"required":["status","data"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]},"TrackedWallet":{"type":"object","properties":{"id":{"type":"number","description":"The unique identifier for the tracked wallet."},"wallet":{"type":"string","description":"The wallet address for which the related wallets are provided."},"label":{"type":"string","description":"The label for the related wallet."},"type":{"$ref":"#/components/schemas/WalletTypes"},"list_id":{"type":"number","description":"The list id for the tracked wallet."},"list":{"$ref":"#/components/schemas/WalletsList"}},"required":["id","wallet","label","type"]},"WalletTypes":{"type":"object","description":"Enumerates the different types of wallets.","enum":["unknown","evm","solana","dydx","bitcoin"]},"WalletsList":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"created_at":{"type":"integer"},"bot_id":{"type":"integer"},"description":{"type":"string"},"is_public":{"type":"boolean"},"followed_count":{"type":"integer"},"wallets_count":{"type":"integer"},"share_url":{"type":"string"},"image_url":{"type":"string"},"followed":{"type":"boolean"},"is_creator":{"type":"boolean"}},"required":["name","created_at","bot_id","description","is_public","followed_count","wallets_count","share_url","image_url","followed","is_creator"]}}}}
```

## The GetTrackedWallets object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"GetTrackedWallets":{"type":"object","description":"The response schema for the /api/v1/tracked-wallets endpoint.","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the standard response status object, which indicates the success or failure of the API request."},"data":{"type":"object","description":"Contains the main data of the response.","properties":{"tracked_wallets":{"type":"array","description":"An array of tracked wallets.","items":{"$ref":"#/components/schemas/TrackedWallet"}},"Paging":{"$ref":"#/components/schemas/TrackedWalletsPaging"}}},"message":{"type":"string","description":"A descriptive message accompanying the response, often used to provide additional information or context about the results or the status of the request."}},"required":["status","data"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]},"TrackedWallet":{"type":"object","properties":{"id":{"type":"number","description":"The unique identifier for the tracked wallet."},"wallet":{"type":"string","description":"The wallet address for which the related wallets are provided."},"label":{"type":"string","description":"The label for the related wallet."},"type":{"$ref":"#/components/schemas/WalletTypes"},"list_id":{"type":"number","description":"The list id for the tracked wallet."},"list":{"$ref":"#/components/schemas/WalletsList"}},"required":["id","wallet","label","type"]},"WalletTypes":{"type":"object","description":"Enumerates the different types of wallets.","enum":["unknown","evm","solana","dydx","bitcoin"]},"WalletsList":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"created_at":{"type":"integer"},"bot_id":{"type":"integer"},"description":{"type":"string"},"is_public":{"type":"boolean"},"followed_count":{"type":"integer"},"wallets_count":{"type":"integer"},"share_url":{"type":"string"},"image_url":{"type":"string"},"followed":{"type":"boolean"},"is_creator":{"type":"boolean"}},"required":["name","created_at","bot_id","description","is_public","followed_count","wallets_count","share_url","image_url","followed","is_creator"]},"TrackedWalletsPaging":{"type":"object","properties":{"total_rows_in_page":{"type":"number","description":"The total number of rows in the current page."},"has_next_page":{"type":"boolean","description":"Indicates whether there is a next page of results."},"next_object":{"type":"number","description":"The index of the next object in the result set."}},"required":["total_rows_in_page","has_next_page","next_object"]}}}}
```

## The AddTrackedWallet object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"AddTrackedWallet":{"type":"object","description":"The response schema for the /api/v1/tracked-wallets endpoint.","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the standard response status object, which indicates the success or failure of the API request."},"data":{"$ref":"#/components/schemas/TrackedWallet"}},"required":["status","data"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]},"TrackedWallet":{"type":"object","properties":{"id":{"type":"number","description":"The unique identifier for the tracked wallet."},"wallet":{"type":"string","description":"The wallet address for which the related wallets are provided."},"label":{"type":"string","description":"The label for the related wallet."},"type":{"$ref":"#/components/schemas/WalletTypes"},"list_id":{"type":"number","description":"The list id for the tracked wallet."},"list":{"$ref":"#/components/schemas/WalletsList"}},"required":["id","wallet","label","type"]},"WalletTypes":{"type":"object","description":"Enumerates the different types of wallets.","enum":["unknown","evm","solana","dydx","bitcoin"]},"WalletsList":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"created_at":{"type":"integer"},"bot_id":{"type":"integer"},"description":{"type":"string"},"is_public":{"type":"boolean"},"followed_count":{"type":"integer"},"wallets_count":{"type":"integer"},"share_url":{"type":"string"},"image_url":{"type":"string"},"followed":{"type":"boolean"},"is_creator":{"type":"boolean"}},"required":["name","created_at","bot_id","description","is_public","followed_count","wallets_count","share_url","image_url","followed","is_creator"]}}}}
```

## The UpdateTrackedWallet object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"UpdateTrackedWallet":{"type":"object","description":"The response schema for the /api/v1/tracked-wallets/{wallet_id} endpoint.","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the standard response status object, which indicates the success or failure of the API request."},"data":{"$ref":"#/components/schemas/TrackedWallet"}},"required":["status","data"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]},"TrackedWallet":{"type":"object","properties":{"id":{"type":"number","description":"The unique identifier for the tracked wallet."},"wallet":{"type":"string","description":"The wallet address for which the related wallets are provided."},"label":{"type":"string","description":"The label for the related wallet."},"type":{"$ref":"#/components/schemas/WalletTypes"},"list_id":{"type":"number","description":"The list id for the tracked wallet."},"list":{"$ref":"#/components/schemas/WalletsList"}},"required":["id","wallet","label","type"]},"WalletTypes":{"type":"object","description":"Enumerates the different types of wallets.","enum":["unknown","evm","solana","dydx","bitcoin"]},"WalletsList":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"created_at":{"type":"integer"},"bot_id":{"type":"integer"},"description":{"type":"string"},"is_public":{"type":"boolean"},"followed_count":{"type":"integer"},"wallets_count":{"type":"integer"},"share_url":{"type":"string"},"image_url":{"type":"string"},"followed":{"type":"boolean"},"is_creator":{"type":"boolean"}},"required":["name","created_at","bot_id","description","is_public","followed_count","wallets_count","share_url","image_url","followed","is_creator"]}}}}
```

## The DeleteTrackedWallets object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"DeleteTrackedWallets":{"type":"object","description":"The response schema for the /api/v1/tracked-wallets endpoint.","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the standard response status object, which indicates the success or failure of the API request."},"message":{"type":"string","description":"A descriptive message accompanying the response, often used to provide additional information or context about the results or the status of the request."}},"required":["status","message"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]}}}}
```

## The TrackedWallet object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"TrackedWallet":{"type":"object","properties":{"id":{"type":"number","description":"The unique identifier for the tracked wallet."},"wallet":{"type":"string","description":"The wallet address for which the related wallets are provided."},"label":{"type":"string","description":"The label for the related wallet."},"type":{"$ref":"#/components/schemas/WalletTypes"},"list_id":{"type":"number","description":"The list id for the tracked wallet."},"list":{"$ref":"#/components/schemas/WalletsList"}},"required":["id","wallet","label","type"]},"WalletTypes":{"type":"object","description":"Enumerates the different types of wallets.","enum":["unknown","evm","solana","dydx","bitcoin"]},"WalletsList":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"created_at":{"type":"integer"},"bot_id":{"type":"integer"},"description":{"type":"string"},"is_public":{"type":"boolean"},"followed_count":{"type":"integer"},"wallets_count":{"type":"integer"},"share_url":{"type":"string"},"image_url":{"type":"string"},"followed":{"type":"boolean"},"is_creator":{"type":"boolean"}},"required":["name","created_at","bot_id","description","is_public","followed_count","wallets_count","share_url","image_url","followed","is_creator"]}}}}
```

## The TrackedWalletsPaging object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"TrackedWalletsPaging":{"type":"object","properties":{"total_rows_in_page":{"type":"number","description":"The total number of rows in the current page."},"has_next_page":{"type":"boolean","description":"Indicates whether there is a next page of results."},"next_object":{"type":"number","description":"The index of the next object in the result set."}},"required":["total_rows_in_page","has_next_page","next_object"]}}}}
```

## The ResponseStatus object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"ResponseStatus":{"type":"string","enum":["ok","error","pending"]}}}}
```

## The ChainsResponse object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"ChainsResponse":{"type":"object","description":"Response containing the list of blockchain networks currently supported by the Cielo API. This is the authoritative live list used to validate the `chains` query parameter across the API (e.g. `/api/v1/feed` and the WebSocket `subscribe_feed` / `subscribe_wallet` commands). Clients can poll this endpoint periodically to stay in sync.\n","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus"},"data":{"type":"array","description":"Array of chain identifiers as used in `chains=` query parameters.","items":{"type":"string"}}},"required":["status","data"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]}}}}
```

## The TokensPNL object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"TokensPNL":{"type":"object","description":"The response schema for the /v1/tokens_pnl endpoint.","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the standard response status object, which indicates the success or failure of the API request."},"data":{"type":"object","description":"Contains the main data of the response, including a list of tokens PNL items and pagination details.","properties":{"items":{"type":"array","description":"An array of tokens PNL items, each providing detailed information on token transactions and performance.","items":{"$ref":"#/components/schemas/TokensPNLItem"}},"paging":{"$ref":"#/components/schemas/PnLPaging"}},"required":["items","paging"]},"message":{"type":"string","description":"A descriptive message accompanying the response, often used to provide additional information or context about the results or the status of the request."}},"required":["status","data"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]},"TokensPNLItem":{"type":"object","properties":{"num_swaps":{"type":"integer","format":"int64"},"num_buys":{"type":"integer","format":"int64","description":"Buy count. num_buys + num_sells == num_swaps."},"num_sells":{"type":"integer","format":"int64","description":"Sell count. num_buys + num_sells == num_swaps."},"total_buy_usd":{"type":"number","format":"double"},"total_buy_amount":{"type":"number","format":"double"},"total_sell_usd":{"type":"number","format":"double"},"total_sell_amount":{"type":"number","format":"double"},"average_buy_price":{"type":"number","format":"double"},"average_sell_price":{"type":"number","format":"double"},"total_pnl_usd":{"type":"number","format":"double"},"roi_percentage":{"type":"number","format":"double"},"unrealized_pnl_usd":{"type":"number","format":"double"},"unrealized_roi_percentage":{"type":"number","format":"double"},"token_price":{"type":"number","format":"double"},"token_address":{"type":"string"},"token_symbol":{"type":"string"},"token_name":{"type":"string"},"chain":{"type":"string"},"is_honeypot":{"type":"boolean"},"holding_time_seconds":{"type":"integer","description":"The token holding time in seconds."},"holding_amount":{"type":"number","format":"double","description":"The current holding amount of the token"},"holding_amount_usd":{"type":"number","format":"double","description":"The current holding amount in USD"},"platform":{"type":"string","description":"Platform or protocol the token is associated with (e.g., \"pump-fun\", \"boop-fun\", \"solana\")"},"platform_ui":{"type":"string","description":"Human-readable platform name (e.g., \"Pump.fun\", \"Boop\", \"Solana\")"},"avg_buy_market_cap_usd":{"type":"number","format":"double","description":"Estimated market cap at the average buy price, calculated as avg_buy_price * (current_market_cap / current_price). Only populated when CieloPricer data is available."},"avg_sell_market_cap_usd":{"type":"number","format":"double","description":"Estimated market cap at the average sell price, calculated as avg_sell_price * (current_market_cap / current_price). Only populated when CieloPricer data is available."},"token_age":{"type":"integer","format":"int64","description":"Time in seconds since the token's launch when the wallet first entered the token."},"held_by":{"type":"string","description":"Wallet address that holds this token. Only present when using multi_bundle_id parameter."},"held_by_labels":{"type":"object","additionalProperties":{"type":"string"},"description":"Map of held_by wallet address to its bundle label. Only wallets that have a non-empty label appear; consumers fall back to the address for the rest. Only present when using multi_bundle_id parameter."}}},"PnLPaging":{"type":"object","properties":{"total_rows_in_page":{"type":"integer","format":"int32"},"has_next_page":{"type":"boolean"},"next_object":{"type":"string"}},"required":["total_rows_in_page","has_next_page"]}}}}
```

## The TokensPNLItem object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"TokensPNLItem":{"type":"object","properties":{"num_swaps":{"type":"integer","format":"int64"},"num_buys":{"type":"integer","format":"int64","description":"Buy count. num_buys + num_sells == num_swaps."},"num_sells":{"type":"integer","format":"int64","description":"Sell count. num_buys + num_sells == num_swaps."},"total_buy_usd":{"type":"number","format":"double"},"total_buy_amount":{"type":"number","format":"double"},"total_sell_usd":{"type":"number","format":"double"},"total_sell_amount":{"type":"number","format":"double"},"average_buy_price":{"type":"number","format":"double"},"average_sell_price":{"type":"number","format":"double"},"total_pnl_usd":{"type":"number","format":"double"},"roi_percentage":{"type":"number","format":"double"},"unrealized_pnl_usd":{"type":"number","format":"double"},"unrealized_roi_percentage":{"type":"number","format":"double"},"token_price":{"type":"number","format":"double"},"token_address":{"type":"string"},"token_symbol":{"type":"string"},"token_name":{"type":"string"},"chain":{"type":"string"},"is_honeypot":{"type":"boolean"},"holding_time_seconds":{"type":"integer","description":"The token holding time in seconds."},"holding_amount":{"type":"number","format":"double","description":"The current holding amount of the token"},"holding_amount_usd":{"type":"number","format":"double","description":"The current holding amount in USD"},"platform":{"type":"string","description":"Platform or protocol the token is associated with (e.g., \"pump-fun\", \"boop-fun\", \"solana\")"},"platform_ui":{"type":"string","description":"Human-readable platform name (e.g., \"Pump.fun\", \"Boop\", \"Solana\")"},"avg_buy_market_cap_usd":{"type":"number","format":"double","description":"Estimated market cap at the average buy price, calculated as avg_buy_price * (current_market_cap / current_price). Only populated when CieloPricer data is available."},"avg_sell_market_cap_usd":{"type":"number","format":"double","description":"Estimated market cap at the average sell price, calculated as avg_sell_price * (current_market_cap / current_price). Only populated when CieloPricer data is available."},"token_age":{"type":"integer","format":"int64","description":"Time in seconds since the token's launch when the wallet first entered the token."},"held_by":{"type":"string","description":"Wallet address that holds this token. Only present when using multi_bundle_id parameter."},"held_by_labels":{"type":"object","additionalProperties":{"type":"string"},"description":"Map of held_by wallet address to its bundle label. Only wallets that have a non-empty label appear; consumers fall back to the address for the rest. Only present when using multi_bundle_id parameter."}}}}}}
```

## The NftsPnL object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"NftsPnL":{"type":"object","description":"The response schema for the /v1/nftss_pnl endpoint.","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the standard response status object, which indicates the success or failure of the API request."},"data":{"type":"object","description":"Contains the main data of the response, including a list of Nft PnL items and pagination details.","properties":{"items":{"type":"array","description":"An array of Nft PnL items, each providing detailed information on token transactions and performance.","items":{"$ref":"#/components/schemas/NftPnLItem"}},"paging":{"$ref":"#/components/schemas/PnLPaging"}},"required":["items","paging"]},"message":{"type":"string","description":"A descriptive message accompanying the response, often used to provide additional information or context about the results or the status of the request."}},"required":["status","data"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]},"NftPnLItem":{"type":"object","properties":{"num_swaps":{"type":"integer","format":"int64"},"total_buy_amount":{"type":"number","format":"double"},"total_sell_amount":{"type":"number","format":"double"},"total_buy_avg":{"type":"number","format":"double"},"total_sell_avg":{"type":"number","format":"double"},"total_buy_usd":{"type":"number","format":"double"},"total_sell_usd":{"type":"number","format":"double"},"profit_loss":{"type":"number","format":"double"},"roi_percentage":{"type":"number","format":"double"},"chain":{"type":"string"},"token_address":{"type":"string"},"nft_symbol":{"type":"string"},"nft_name":{"type":"string"}}},"PnLPaging":{"type":"object","properties":{"total_rows_in_page":{"type":"integer","format":"int32"},"has_next_page":{"type":"boolean"},"next_object":{"type":"string"}},"required":["total_rows_in_page","has_next_page"]}}}}
```

## The NftPnLItem object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"NftPnLItem":{"type":"object","properties":{"num_swaps":{"type":"integer","format":"int64"},"total_buy_amount":{"type":"number","format":"double"},"total_sell_amount":{"type":"number","format":"double"},"total_buy_avg":{"type":"number","format":"double"},"total_sell_avg":{"type":"number","format":"double"},"total_buy_usd":{"type":"number","format":"double"},"total_sell_usd":{"type":"number","format":"double"},"profit_loss":{"type":"number","format":"double"},"roi_percentage":{"type":"number","format":"double"},"chain":{"type":"string"},"token_address":{"type":"string"},"nft_symbol":{"type":"string"},"nft_name":{"type":"string"}}}}}}
```

## The PnLPaging object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"PnLPaging":{"type":"object","properties":{"total_rows_in_page":{"type":"integer","format":"int32"},"has_next_page":{"type":"boolean"},"next_object":{"type":"string"}},"required":["total_rows_in_page","has_next_page"]}}}}
```

## The Paging object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"Paging":{"type":"object","properties":{"page":{"type":"integer","minimum":1},"total_rows_in_page":{"type":"integer","minimum":0},"has_next_page":{"type":"boolean"}},"required":["page","total_rows_in_page","has_next_page"]}}}}
```

## The TokenFlowV2Item object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"TokenFlowV2Item":{"type":"object","properties":{"address":{"type":"string","description":"Token contract address."},"symbol":{"type":"string","description":"Token symbol."},"name":{"type":"string","description":"Token name."},"chain":{"type":"string","description":"Blockchain chain."},"net_flow_usd":{"type":"integer","description":"Net flow in USD (buy - sell)."},"net_flow_usd_width":{"type":"integer","description":"Relative width for net flow visualization."},"net_flow_amount":{"type":"integer","description":"Net flow token amount."},"buy_usd":{"type":"integer","description":"Total buy amount in USD."},"buy_usd_width":{"type":"integer","description":"Relative width for buy visualization."},"buy_amount":{"type":"integer","description":"Total buy token amount."},"sell_usd":{"type":"integer","description":"Total sell amount in USD."},"sell_usd_width":{"type":"integer","description":"Relative width for sell visualization."},"sell_amount":{"type":"integer","description":"Total sell token amount."},"avg_buy_usd":{"type":"integer","description":"Average buy price in USD."},"avg_sell_usd":{"type":"integer","description":"Average sell price in USD."},"wallets_num":{"type":"integer","description":"Number of distinct wallets."},"trades_num":{"type":"integer","description":"Number of trades."},"chart_link":{"type":"string","description":"Link to chart for this token."},"platform":{"type":"string","description":"Token launch platform code (Solana tokens only)."},"platform_uri":{"type":"string","description":"URL to the token on its launch platform (Solana tokens only)."}}}}}}
```

## The NewTokenFlowItem object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"NewTokenFlowItem":{"type":"object","properties":{"chain":{"type":"string","description":"Blockchain chain."},"address":{"type":"string","description":"Token contract address."},"symbol":{"type":"string","description":"Token symbol."},"name":{"type":"string","description":"Token name."},"net_flow_usd":{"type":"integer","description":"Net flow in USD (buy - sell)."},"net_flow_usd_width":{"type":"integer","description":"Relative width for net flow visualization."},"net_flow_amount":{"type":"integer","description":"Net flow token amount."},"buy_usd":{"type":"integer","description":"Total buy amount in USD."},"buy_usd_width":{"type":"integer","description":"Relative width for buy visualization."},"buy_amount":{"type":"integer","description":"Total buy token amount."},"sell_usd":{"type":"integer","description":"Total sell amount in USD."},"sell_usd_width":{"type":"integer","description":"Relative width for sell visualization."},"sell_amount":{"type":"integer","description":"Total sell token amount."},"avg_buy_usd":{"type":"integer","description":"Average buy price in USD."},"avg_sell_usd":{"type":"integer","description":"Average sell price in USD."},"wallets_num":{"type":"integer","description":"Number of distinct wallets."},"trades_num":{"type":"integer","description":"Number of trades."},"timestamp":{"type":"integer","description":"Token creation timestamp (Unix epoch)."},"chart_link":{"type":"string","description":"Link to chart for this token."},"platform":{"type":"string","description":"Token launch platform code (Solana tokens only)."},"platform_uri":{"type":"string","description":"URL to the token on its launch platform (Solana tokens only)."}}}}}}
```

## The TokenMetadataResponse object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"TokenMetadataResponse":{"type":"object","description":"Token metadata response","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the standard response status object, which indicates the success or failure of the API request."},"data":{"type":"object","description":"Contains token metadata information.","properties":{"chain":{"type":"string","description":"The blockchain network on which the token is deployed."},"address":{"type":"string","description":"The address of the token contract."},"name":{"type":"string","description":"The name of the token."},"symbol":{"type":"string","description":"The symbol of the token."},"decimals":{"type":"integer","description":"The number of decimal places used by the token."},"created_at_ts":{"type":"integer","description":"Timestamp when the token was created."},"created_at_block":{"type":"integer","description":"Block number when the token was created."},"twitter":{"type":"string","description":"Official Twitter account of the project."},"telegram":{"type":"string","description":"Official Telegram channel for the project."},"website":{"type":"string","description":"Official website of the project."},"supply":{"type":"integer","description":"The total supply of the token."},"logo_uri":{"type":"string","description":"The URI of the token's logo."},"migrated_at":{"type":"integer","description":"Unix timestamp when the token migrated. 0 if not migrated."},"migrated_from_pool":{"type":"string","description":"The pool address the token migrated from."},"migrated_to_pool":{"type":"string","description":"The pool address the token migrated to."},"migration_tx":{"type":"string","description":"The migration transaction hash."},"migration_price_usd":{"type":"number","nullable":true,"description":"Token price in USD at migration time. Null if not migrated."},"migration_price_native":{"type":"number","nullable":true,"description":"Token price in native token (e.g. SOL) at migration time. Null if not migrated."},"migration_market_cap_usd":{"type":"number","nullable":true,"description":"Market cap in USD at migration time. Null if not migrated."},"is_mayhem_mode":{"type":"boolean","description":"Whether the token launched in pump.fun \"Mayhem Mode\" — an opt-in coin-creation setting where an AI agent trades the coin for its first 24h. Only pump.fun tokens can be true; false for everything else."}},"required":["chain","address","name","symbol","decimals","created_at_ts","created_at_block","supply","logo_uri"]},"message":{"type":"string","description":"A message describing the result of the API request."}},"required":["status","data"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]}}}}
```

## The TokenPriceResponse object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"TokenPriceResponse":{"type":"object","description":"Token price response","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the standard response status object, which indicates the success or failure of the API request."},"data":{"type":"object","description":"Contains token price.","properties":{"chain":{"type":"string","description":"The blockchain network on which the token is deployed."},"address":{"type":"string","description":"The address of the token contract."},"block_number":{"type":"integer","description":"The block number at which the price was recorded."},"price":{"type":"number","description":"The price of the token in USD."}},"required":["chain","address","block_number","price"]},"message":{"type":"string","description":"A message describing the result of the API request."}},"required":["status","data"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]}}}}
```

## The TokenStatsResponse object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"TokenStatsResponse":{"type":"object","description":"Response containing detailed statistics for a specific token including price, market cap, and trading volume metrics","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the standard response status object, which indicates the success or failure of the API request."},"data":{"type":"object","description":"Contains comprehensive token statistics information.","properties":{"trader_counts":{"type":"object","description":"Distinct Solana trading wallets observed since counting began, not current holders or complete historical lifetime totals. Repeated trades count once per token. A wallet remains pro after its first confirmed pro trade. Omitted when counting is disabled or unsupported; independent of include_liquidity.","required":["status","pro_ratio"],"properties":{"status":{"type":"string","enum":["observed","unavailable"],"description":"Unavailable means no count is known; it must not be interpreted as zero."},"total_wallets":{"type":"integer","format":"int64","minimum":0},"pro_wallets":{"type":"integer","format":"int64","minimum":0},"pro_ratio":{"type":"number","nullable":true,"minimum":0,"maximum":1,"description":"pro_wallets / total_wallets; null when unavailable or total_wallets is zero."},"observed_since":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"token_address":{"type":"string","description":"The unique address of the token contract on the blockchain."},"price_usd":{"type":"number","description":"The current price of the token in USD."},"market_cap_usd":{"type":"number","description":"The total market capitalization of the token in USD (calculated as price × circulating supply)."},"ath_price_usd":{"type":"number","description":"The all-time high price of the token in USD. On Solana, Base, Robinhood and Arc it is the highest daily candle high of the token's Cielo chart series (the same pools the chart is drawn from); on other chains it is the highest recorded swap price across all pools. 0 when the chart series has no candles yet or could not be fetched in time; a later request returns the value once it is available."},"ath_market_cap_usd":{"type":"number","description":"The market capitalization at the token's all-time-high price in USD, valued using the CURRENT circulating supply (ath_price_usd × current supply). This is an approximation, not a point-in-time snapshot from the ATH block, and can differ from the true historical cap for tokens whose supply changed since the ATH."},"ath_date":{"type":"integer","format":"int64","description":"The Unix timestamp of the all-time high. On Solana, Base, Robinhood and Arc it is the start (00:00 UTC) of the day whose daily candle set the high; on other chains it is the time of the swap. Omitted when there is no all-time high."},"tax_rate":{"type":"number","description":"Token tax percentage (e.g. 5 = 5% tax), derived from the token's pools. Only present when include_liquidity=true (the default); omitted entirely on include_liquidity=false responses, where pool data is not computed. When present, 0 means no tax."},"total_fees_sol":{"type":"number","description":"Total collected fees across the token's pools, in SOL. Solana only. Only present when include_liquidity=true (the default); omitted on include_liquidity=false responses."},"total_fees_usd":{"type":"number","description":"Total collected fees across the token's pools in USD, estimated from the native-liquidity-implied SOL price. Solana only. Only present when include_liquidity=true (the default); omitted on include_liquidity=false responses."},"twitter":{"type":"string","description":"The token's X (Twitter) URL, or empty string when not set."},"x_link_type":{"type":"string","enum":["post","account","community","other",""],"description":"Classification of the X (Twitter) link: post (tweet), account (profile), community, other (search/hashtag/etc), or \"\" when there is no X link. Use it to pick the distinct X icon on the frontend."},"change":{"type":"object","description":"Price percentage changes over different time periods.","properties":{"1h":{"type":"number","description":"Price percentage change over the last hour."},"24h":{"type":"number","description":"Price percentage change over the last 24 hours."},"5m":{"type":"number","description":"Price percentage change over the last 5 minutes."},"6h":{"type":"number","description":"Price percentage change over the last 6 hours."}}},"volume":{"type":"object","description":"Trading volume statistics across different time periods.","properties":{"5m":{"$ref":"#/components/schemas/VolumeStats","description":"Trading statistics for the last 5 minutes."},"1h":{"$ref":"#/components/schemas/VolumeStats","description":"Trading statistics for the last hour."},"6h":{"$ref":"#/components/schemas/VolumeStats","description":"Trading statistics for the last 6 hours."},"24h":{"$ref":"#/components/schemas/VolumeStats","description":"Trading statistics for the last 24 hours."}}},"migration_price_usd":{"type":"number","nullable":true,"description":"Token price in USD at migration time. Null if not migrated."},"migration_price_native":{"type":"number","nullable":true,"description":"Token price in native token (e.g. SOL) at migration time. Null if not migrated."},"migration_market_cap_usd":{"type":"number","nullable":true,"description":"Market cap in USD at migration time. Null if not migrated."},"active_users":{"type":"integer","format":"int64","description":"Number of Cielo users currently viewing this token's chart (open connections). Best-effort: 0 when nobody is viewing, and also 0 when the upstream count is momentarily unavailable."}},"required":["token_address","price_usd","market_cap_usd","change","volume"]},"message":{"type":"string","description":"A message describing the result of the API request."}},"required":["status","data"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]},"VolumeStats":{"type":"object","description":"Trading volume statistics for a specific time period","properties":{"volume_usd":{"type":"number","description":"Total trading volume in USD for the time period."},"buy_volume_usd":{"type":"number","description":"Total buy volume in USD for the time period."},"sell_volume_usd":{"type":"number","description":"Total sell volume in USD for the time period."},"unique_buyers":{"type":"integer","description":"Number of unique addresses that bought the token in the time period."},"unique_sellers":{"type":"integer","description":"Number of unique addresses that sold the token in the time period."},"buys":{"type":"integer","description":"Total number of buy transactions in the time period."},"sells":{"type":"integer","description":"Total number of sell transactions in the time period."}},"required":["volume_usd","buy_volume_usd","sell_volume_usd","unique_buyers","unique_sellers","buys","sells"]}}}}
```

## The TokenStatsLiquidityResponse object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"TokenStatsLiquidityResponse":{"type":"object","description":"Liquidity slice of /token/stats, returned by the dedicated /token/stats-liquidity endpoint.","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"Standard response status indicating success or failure of the API request."},"data":{"type":"object","description":"Aggregated liquidity information for the token.","properties":{"chain":{"type":"string","description":"Blockchain network."},"token_address":{"type":"string","description":"The token contract address."},"price_usd":{"type":"number","description":"The current price of the token in USD, valued from the most-liquid pool (matches /token/stats)."},"market_cap_usd":{"type":"number","description":"The total market capitalization of the token in USD (price × circulating supply), valued from the most-liquid pool."},"relevant_pool_tax":{"type":"number","description":"Tax rate of the backend-selected top pool (the most-liquid pool that also drives price_usd/market_cap_usd). Same units as the per-pool tax_rate (e.g. 5 = 5%). Use this instead of scanning pools for a tax value. Zero when no pool reports a tax."},"relevant_pool_address":{"type":"string","description":"Address of the selected top pool that relevant_pool_tax refers to. Empty when no pool qualifies."},"is_spam":{"type":"boolean","description":"True when total liquidity is below the spam threshold or unavailable."},"total_fees":{"type":"string","description":"Sum of all collected fees across pools, as a decimal string. Solana only; omitted when the fee totals could not be resolved."},"total_base_fees":{"type":"string","description":"Sum of base fees across pools, as a decimal string. Solana only; omitted when the fee totals could not be resolved."},"total_priority_fees":{"type":"string","description":"Sum of priority fees across pools, as a decimal string. Solana only; omitted when the fee totals could not be resolved."},"total_propagator_fees":{"type":"string","description":"Sum of propagator fees across pools, as a decimal string. Solana only; omitted when the fee totals could not be resolved."},"total_protocol_fees":{"type":"string","description":"Sum of protocol fees across pools, as a decimal string. Solana only; omitted when the fee totals could not be resolved."},"total_trading_fees":{"type":"string","description":"Sum of trading fees across pools, as a decimal string. Solana only; omitted when the fee totals could not be resolved."},"total_creator_fees":{"type":"string","description":"Sum of creator fees across pools, as a decimal string. Solana only; omitted when the fee totals could not be resolved."},"total_referral_fees":{"type":"string","description":"Sum of referral fees across pools, as a decimal string. Solana only; omitted when the fee totals could not be resolved."},"total_fees_sol":{"type":"number","format":"float","description":"total_fees expressed in the chain's native token (SOL). Solana only; omitted when the fee totals could not be resolved."},"total_fees_usd":{"type":"number","format":"float","description":"total_fees_sol valued in USD from the native-liquidity-implied SOL price. Solana only; omitted when the fee totals could not be resolved, and 0 when the token has no native-token pool to imply a price from."},"liquidity":{"type":"object","description":"Aggregated liquidity totals across all pools.","properties":{"total_liquidity_usd":{"type":"number","description":"Total liquidity in USD across all pools."},"usd_liquidity":{"type":"number","description":"Liquidity provided in USD-denominated paired tokens."},"usd_pools":{"type":"integer","description":"Number of pools paired with a USD-denominated token."},"native_liquidity":{"type":"number","description":"Liquidity provided in the chain's native token."},"native_liquidity_usd":{"type":"number","description":"USD value of the native-token liquidity."},"native_pools":{"type":"integer","description":"Number of pools paired with the native token."}}},"pools":{"type":"array","description":"List of liquidity pools sorted by liquidity_usd descending.","items":{"type":"object","properties":{"likely_spam":{"type":"boolean"},"liquidity_native":{"type":"number"},"liquidity":{"type":"number"},"liquidity_usd":{"type":"number"},"paired_token":{"type":"string"},"paired_token_symbol":{"type":"string"},"paired_token_name":{"type":"string"},"pool_address":{"type":"string"},"protocol":{"type":"string"},"protocol_ui":{"type":"string"},"tax_rate":{"type":"number","nullable":true}}}}},"required":["chain","token_address","liquidity"]},"message":{"type":"string"}},"required":["status","data"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]}}}}
```

## The TokenChecklistResponse object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"TokenChecklistResponse":{"type":"object","description":"Token checklist response containing safety and distribution metrics for a token","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the standard response status object, which indicates the success or failure of the API request."},"data":{"type":"object","description":"Contains token checklist information.","properties":{"dex_paid":{"type":"boolean","description":"Whether the token has paid for DEX listing."},"dex_paid_at":{"type":"integer","description":"Timestamp when the token paid for DEX listing. Omitted when the token has not paid for a DEX listing."},"top_20_holders_percent":{"type":"number","description":"Percentage of total supply held by the top 20 holders."},"holders":{"type":"integer","description":"Total number of token holders."},"developer":{"type":"string","description":"The developer wallet address."},"developer_balance":{"type":"object","description":"Developer's token balance information.","properties":{"amount":{"type":"number","description":"Developer's token balance amount."},"amount_usd":{"type":"number","description":"Developer's token balance value in USD."},"amount_native":{"type":"number","description":"Developer's balance in native token."},"supply_owned_percent":{"type":"number","description":"Percentage of total supply owned by the developer."}},"required":["amount","amount_usd","amount_native","supply_owned_percent"]},"snipers_holding_percent":{"type":"number","description":"Percentage of total supply held by snipers."},"bundlers_holding_percent":{"type":"number","description":"Percentage of total supply held by bundlers."},"top_holder_dump_risk":{"description":"Estimated price drawdown if the largest non-pool holder sold their entire position into the token's top pools. Omitted when it cannot be estimated.","allOf":[{"$ref":"#/components/schemas/DumpRisk"}]},"top_5_holders_dump_risk":{"description":"Estimated price drawdown if the five largest non-pool holders sold their entire positions into the token's top pools. Omitted when it cannot be estimated.","allOf":[{"$ref":"#/components/schemas/DumpRisk"}]},"migration":{"type":"object","description":"Token migration status information.","nullable":true,"properties":{"has_launchpad_pool":{"type":"boolean","description":"Whether the token has a launchpad pool."},"bonding_curve_percentage":{"type":"number","description":"Bonding curve completion percentage."},"migrating_from_protocol":{"type":"string","description":"The protocol the token is migrating from."},"migrated":{"type":"boolean","description":"Whether the token has completed migration."},"blacklisted_token":{"type":"boolean","description":"Whether the token is blacklisted."},"migrated_at":{"type":"integer","description":"Timestamp when the token migrated."},"migrated_from_pool":{"type":"string","description":"The pool address the token migrated from."},"migrated_to_pool":{"type":"string","description":"The pool address the token migrated to."},"migration_tx":{"type":"string","description":"The migration transaction hash."}}}},"required":["dex_paid","top_20_holders_percent","holders","developer","developer_balance","snipers_holding_percent","bundlers_holding_percent"]},"message":{"type":"string","description":"A message describing the result of the API request."}},"required":["status","data"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]},"DumpRisk":{"type":"object","description":"Estimated sell-pressure impact of a holder position, from a constant-product model over the token's top pools.","properties":{"percent":{"type":"number","description":"Estimated price drop in percent (0-100)."},"amount_usd":{"type":"number","description":"USD value of the position at the current token price."}},"required":["percent","amount_usd"]}}}}
```

## The DumpRisk object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"DumpRisk":{"type":"object","description":"Estimated sell-pressure impact of a holder position, from a constant-product model over the token's top pools.","properties":{"percent":{"type":"number","description":"Estimated price drop in percent (0-100)."},"amount_usd":{"type":"number","description":"USD value of the position at the current token price."}},"required":["percent","amount_usd"]}}}}
```

## The VolumeStats object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"VolumeStats":{"type":"object","description":"Trading volume statistics for a specific time period","properties":{"volume_usd":{"type":"number","description":"Total trading volume in USD for the time period."},"buy_volume_usd":{"type":"number","description":"Total buy volume in USD for the time period."},"sell_volume_usd":{"type":"number","description":"Total sell volume in USD for the time period."},"unique_buyers":{"type":"integer","description":"Number of unique addresses that bought the token in the time period."},"unique_sellers":{"type":"integer","description":"Number of unique addresses that sold the token in the time period."},"buys":{"type":"integer","description":"Total number of buy transactions in the time period."},"sells":{"type":"integer","description":"Total number of sell transactions in the time period."}},"required":["volume_usd","buy_volume_usd","sell_volume_usd","unique_buyers","unique_sellers","buys","sells"]}}}}
```

## The TrendingTokensResponse object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"TrendingTokensResponse":{"type":"object","properties":{"status":{"type":"string"},"message":{"type":"string"},"data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/TrendingTokenItem"}},"epoch_offset":{"type":"object","properties":{"epoch":{"type":"string"},"offset":{"type":"integer"}}},"paging":{"type":"object","properties":{"next_cursor":{"type":"string"}}}}}}},"TrendingTokenItem":{"type":"object","properties":{"token_address":{"type":"string","description":"The token contract address."},"token_symbol":{"type":"string","description":"The token symbol."},"token_name":{"type":"string","description":"The token name."},"chain":{"type":"string","description":"The blockchain network."},"platform":{"type":"string","description":"The platform code."},"platform_ui":{"type":"string","description":"Human-readable platform name."},"platform_uri":{"type":"string","description":"Platform URI."},"market_cap":{"type":"number","description":"Market cap in USD."},"liquidity":{"type":"number","description":"Total liquidity in USD."},"volume_24h":{"type":"number","description":"24-hour trading volume in USD."},"unique_wallets":{"type":"integer","description":"Number of unique wallets that traded this token in the given interval."},"holders":{"type":"integer","description":"Number of token holders."},"mindshare":{"type":"number","description":"Mindshare score."},"mindshare_breakdown":{"type":"array","items":{"type":"object","properties":{"count":{"type":"integer"},"label":{"type":"string"},"percentage":{"type":"number"}}}},"price_change_percentage":{"type":"number","description":"Price change percentage."},"net_flow":{"type":"number","description":"Net flow value."},"popular_wallets":{"type":"integer","description":"Number of popular wallets."},"whales":{"type":"integer","description":"Number of whale wallets."},"fresh_wallets_percentage":{"type":"number","description":"Percentage of fresh wallets."},"sniper_percentage":{"type":"number","description":"Percentage of sniper wallets."},"dev_percentage":{"type":"number","description":"Developer wallet percentage."},"top_20_percentage":{"type":"number","description":"Top 20 holders percentage."},"bonding_curve_percentage":{"type":"number","description":"Bonding curve percentage."},"avg_buy":{"type":"number","description":"Average buy amount."},"buy_count":{"type":"integer","description":"Number of buy transactions."},"sell_count":{"type":"integer","description":"Number of sell transactions."},"buy_volume_usd":{"type":"number","description":"Buy volume in USD."},"sell_volume_usd":{"type":"number","description":"Sell volume in USD."},"token_age":{"type":"integer","description":"Token age in seconds."},"dex_paid":{"type":"boolean","description":"Whether DEX has been paid."},"is_deleted":{"type":"integer","description":"Deletion flag."},"telegram":{"type":"string","description":"Telegram link."},"website":{"type":"string","description":"Website URL."}}}}}}
```

## The TrendingTokenItem object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"TrendingTokenItem":{"type":"object","properties":{"token_address":{"type":"string","description":"The token contract address."},"token_symbol":{"type":"string","description":"The token symbol."},"token_name":{"type":"string","description":"The token name."},"chain":{"type":"string","description":"The blockchain network."},"platform":{"type":"string","description":"The platform code."},"platform_ui":{"type":"string","description":"Human-readable platform name."},"platform_uri":{"type":"string","description":"Platform URI."},"market_cap":{"type":"number","description":"Market cap in USD."},"liquidity":{"type":"number","description":"Total liquidity in USD."},"volume_24h":{"type":"number","description":"24-hour trading volume in USD."},"unique_wallets":{"type":"integer","description":"Number of unique wallets that traded this token in the given interval."},"holders":{"type":"integer","description":"Number of token holders."},"mindshare":{"type":"number","description":"Mindshare score."},"mindshare_breakdown":{"type":"array","items":{"type":"object","properties":{"count":{"type":"integer"},"label":{"type":"string"},"percentage":{"type":"number"}}}},"price_change_percentage":{"type":"number","description":"Price change percentage."},"net_flow":{"type":"number","description":"Net flow value."},"popular_wallets":{"type":"integer","description":"Number of popular wallets."},"whales":{"type":"integer","description":"Number of whale wallets."},"fresh_wallets_percentage":{"type":"number","description":"Percentage of fresh wallets."},"sniper_percentage":{"type":"number","description":"Percentage of sniper wallets."},"dev_percentage":{"type":"number","description":"Developer wallet percentage."},"top_20_percentage":{"type":"number","description":"Top 20 holders percentage."},"bonding_curve_percentage":{"type":"number","description":"Bonding curve percentage."},"avg_buy":{"type":"number","description":"Average buy amount."},"buy_count":{"type":"integer","description":"Number of buy transactions."},"sell_count":{"type":"integer","description":"Number of sell transactions."},"buy_volume_usd":{"type":"number","description":"Buy volume in USD."},"sell_volume_usd":{"type":"number","description":"Sell volume in USD."},"token_age":{"type":"integer","description":"Token age in seconds."},"dex_paid":{"type":"boolean","description":"Whether DEX has been paid."},"is_deleted":{"type":"integer","description":"Deletion flag."},"telegram":{"type":"string","description":"Telegram link."},"website":{"type":"string","description":"Website URL."}}}}}}
```

## The GetAllWalletsListsResponse object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"GetAllWalletsListsResponse":{"type":"object","description":"The response schema for the /api/v1/lists/all endpoint.","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the standard response status object, which indicates the success or failure of the API request."},"data":{"type":"object","description":"Contains the main data of the response.","properties":{"lists":{"type":"array","description":"An array of all lists.","items":{"$ref":"#/components/schemas/WalletsList"}},"Paging":{"$ref":"#/components/schemas/WalletsListPaging"}}},"message":{"type":"string","description":"A descriptive message accompanying the response, often used to provide additional information or context about the results or the status of the request."}},"required":["status","data"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]},"WalletsList":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"created_at":{"type":"integer"},"bot_id":{"type":"integer"},"description":{"type":"string"},"is_public":{"type":"boolean"},"followed_count":{"type":"integer"},"wallets_count":{"type":"integer"},"share_url":{"type":"string"},"image_url":{"type":"string"},"followed":{"type":"boolean"},"is_creator":{"type":"boolean"}},"required":["name","created_at","bot_id","description","is_public","followed_count","wallets_count","share_url","image_url","followed","is_creator"]},"WalletsListPaging":{"type":"object","properties":{"total_rows_in_page":{"type":"integer"},"has_next_page":{"type":"boolean"},"next_object":{"type":"string"}},"required":["total_rows_in_page","has_next_page","next_object"]}}}}
```

## The GetUserListsResponse object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"GetUserListsResponse":{"type":"object","description":"The response schema for the /api/v1/lists endpoint.","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the standard response status object, which indicates the success or failure of the API request."},"data":{"type":"array","description":"Contains the main data of the response.","items":{"$ref":"#/components/schemas/WalletsList"}},"message":{"type":"string","description":"A descriptive message accompanying the response, often used to provide additional information or context about the results or the status of the request."}},"required":["status","data"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]},"WalletsList":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"created_at":{"type":"integer"},"bot_id":{"type":"integer"},"description":{"type":"string"},"is_public":{"type":"boolean"},"followed_count":{"type":"integer"},"wallets_count":{"type":"integer"},"share_url":{"type":"string"},"image_url":{"type":"string"},"followed":{"type":"boolean"},"is_creator":{"type":"boolean"}},"required":["name","created_at","bot_id","description","is_public","followed_count","wallets_count","share_url","image_url","followed","is_creator"]}}}}
```

## The CreateUserListRequest object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"CreateUserListRequest":{"type":"object","properties":{"name":{"type":"string"},"is_public":{"type":"boolean"},"wallets":{"type":"array","items":{"type":"integer"}},"followed_list_id":{"type":"integer"},"description":{"type":"string"}},"required":["name"]}}}}
```

## The CreateUserListResponse object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"CreateUserListResponse":{"type":"object","description":"The response schema for the /api/v1/lists endpoint.","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the standard response status object, which indicates the success or failure of the API request."},"data":{"$ref":"#/components/schemas/WalletsList"},"message":{"type":"string","description":"A descriptive message accompanying the response, often used to provide additional information or context about the results or the status of the request."}},"required":["status","data"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]},"WalletsList":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"created_at":{"type":"integer"},"bot_id":{"type":"integer"},"description":{"type":"string"},"is_public":{"type":"boolean"},"followed_count":{"type":"integer"},"wallets_count":{"type":"integer"},"share_url":{"type":"string"},"image_url":{"type":"string"},"followed":{"type":"boolean"},"is_creator":{"type":"boolean"}},"required":["name","created_at","bot_id","description","is_public","followed_count","wallets_count","share_url","image_url","followed","is_creator"]}}}}
```

## The UpdateUserListRequest object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"UpdateUserListRequest":{"type":"object","properties":{"name":{"type":"string"},"is_public":{"type":"boolean"},"wallets":{"type":"array","items":{"type":"integer"}},"followed_list_id":{"type":"integer"},"description":{"type":"string"}},"required":["name"]}}}}
```

## The UpdateUserListResponse object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"UpdateUserListResponse":{"type":"object","description":"The response schema for the /api/v1/lists/{list_id} endpoint.","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the standard response status object, which indicates the success or failure of the API request."},"data":{"$ref":"#/components/schemas/WalletsList"},"message":{"type":"string","description":"A descriptive message accompanying the response, often used to provide additional information or context about the results or the status of the request."}},"required":["status","data"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]},"WalletsList":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"created_at":{"type":"integer"},"bot_id":{"type":"integer"},"description":{"type":"string"},"is_public":{"type":"boolean"},"followed_count":{"type":"integer"},"wallets_count":{"type":"integer"},"share_url":{"type":"string"},"image_url":{"type":"string"},"followed":{"type":"boolean"},"is_creator":{"type":"boolean"}},"required":["name","created_at","bot_id","description","is_public","followed_count","wallets_count","share_url","image_url","followed","is_creator"]}}}}
```

## The DeleteUserListResponse object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"DeleteUserListResponse":{"type":"object","description":"The response schema for the /api/v1/lists/{list_id} endpoint.","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the standard response status object, which indicates the success or failure of the API request."},"message":{"type":"string","description":"A descriptive message accompanying the response, often used to provide additional information or context about the results or the status of the request."}},"required":["status","message"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]}}}}
```

## The ToggleFollowListResponse object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"ToggleFollowListResponse":{"type":"object","description":"The response schema for the /api/v1/lists/{list_id}/toggle-follow endpoint.","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the standard response status object, which indicates the success or failure of the API request."},"data":{"type":"object","description":"Contains the main data of the response.","properties":{"followed":{"type":"boolean","description":"The follow status of the list."}}},"message":{"type":"string","description":"A descriptive message accompanying the response, often used to provide additional information or context about the results or the status of the request."}},"required":["status","data"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]}}}}
```

## The WalletsList object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"WalletsList":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"created_at":{"type":"integer"},"bot_id":{"type":"integer"},"description":{"type":"string"},"is_public":{"type":"boolean"},"followed_count":{"type":"integer"},"wallets_count":{"type":"integer"},"share_url":{"type":"string"},"image_url":{"type":"string"},"followed":{"type":"boolean"},"is_creator":{"type":"boolean"}},"required":["name","created_at","bot_id","description","is_public","followed_count","wallets_count","share_url","image_url","followed","is_creator"]}}}}
```

## The WalletsListPaging object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"WalletsListPaging":{"type":"object","properties":{"total_rows_in_page":{"type":"integer"},"has_next_page":{"type":"boolean"},"next_object":{"type":"string"}},"required":["total_rows_in_page","has_next_page","next_object"]}}}}
```

## The WebsocketCommand object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"WebsocketCommand":{"type":"object","oneOf":[{"$ref":"#/components/schemas/WalletSubscribeCommand"},{"$ref":"#/components/schemas/WalletUnsubscribeCommand"},{"$ref":"#/components/schemas/FeedSubscribeCommand"},{"$ref":"#/components/schemas/FeedUnsubscribeCommand"}]},"WalletSubscribeCommand":{"type":"object","properties":{"type":{"type":"string","enum":["subscribe_wallet"]},"wallet":{"type":"string"},"filter":{"$ref":"#/components/schemas/CommandFilter"}},"required":["type","wallet"]},"CommandFilter":{"type":"object","properties":{"tx_types":{"type":"array","items":{"type":"string","enum":["bridge","contract_creation","contract_interaction","flashloan","lending","lp","nft_lending","nft_liquidation","nft_mint","nft_sweep","nft_trade","nft_transfer","option","perp","reward","staking","sudo_pool","swap","transfer","wrap"]},"description":"The types of transactions to filter."},"chains":{"type":"array","items":{"type":"string"},"description":"The chains to filter."},"tokens":{"type":"array","items":{"type":"string"},"description":"The tokens to filter."},"min_usd_value":{"type":"number","description":"The minimum USD value to filter."}}},"WalletUnsubscribeCommand":{"type":"object","properties":{"type":{"type":"string","enum":["unsubscribe_wallet"]},"wallet":{"type":"string"}},"required":["type","wallet"]},"FeedSubscribeCommand":{"type":"object","properties":{"type":{"type":"string","enum":["subscribe_feed"]},"list_id":{"type":"string"},"filter":{"$ref":"#/components/schemas/CommandFilter"}},"required":["type","list_id"]},"FeedUnsubscribeCommand":{"type":"object","properties":{"type":{"type":"string","enum":["unsubscribe_feed"]}},"required":["type"]}}}}
```

## The WalletSubscribeCommand object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"WalletSubscribeCommand":{"type":"object","properties":{"type":{"type":"string","enum":["subscribe_wallet"]},"wallet":{"type":"string"},"filter":{"$ref":"#/components/schemas/CommandFilter"}},"required":["type","wallet"]},"CommandFilter":{"type":"object","properties":{"tx_types":{"type":"array","items":{"type":"string","enum":["bridge","contract_creation","contract_interaction","flashloan","lending","lp","nft_lending","nft_liquidation","nft_mint","nft_sweep","nft_trade","nft_transfer","option","perp","reward","staking","sudo_pool","swap","transfer","wrap"]},"description":"The types of transactions to filter."},"chains":{"type":"array","items":{"type":"string"},"description":"The chains to filter."},"tokens":{"type":"array","items":{"type":"string"},"description":"The tokens to filter."},"min_usd_value":{"type":"number","description":"The minimum USD value to filter."}}}}}}
```

## The WalletUnsubscribeCommand object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"WalletUnsubscribeCommand":{"type":"object","properties":{"type":{"type":"string","enum":["unsubscribe_wallet"]},"wallet":{"type":"string"}},"required":["type","wallet"]}}}}
```

## The FeedSubscribeCommand object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"FeedSubscribeCommand":{"type":"object","properties":{"type":{"type":"string","enum":["subscribe_feed"]},"list_id":{"type":"string"},"filter":{"$ref":"#/components/schemas/CommandFilter"}},"required":["type","list_id"]},"CommandFilter":{"type":"object","properties":{"tx_types":{"type":"array","items":{"type":"string","enum":["bridge","contract_creation","contract_interaction","flashloan","lending","lp","nft_lending","nft_liquidation","nft_mint","nft_sweep","nft_trade","nft_transfer","option","perp","reward","staking","sudo_pool","swap","transfer","wrap"]},"description":"The types of transactions to filter."},"chains":{"type":"array","items":{"type":"string"},"description":"The chains to filter."},"tokens":{"type":"array","items":{"type":"string"},"description":"The tokens to filter."},"min_usd_value":{"type":"number","description":"The minimum USD value to filter."}}}}}}
```

## The FeedUnsubscribeCommand object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"FeedUnsubscribeCommand":{"type":"object","properties":{"type":{"type":"string","enum":["unsubscribe_feed"]}},"required":["type"]}}}}
```

## The CommandFilter object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"CommandFilter":{"type":"object","properties":{"tx_types":{"type":"array","items":{"type":"string","enum":["bridge","contract_creation","contract_interaction","flashloan","lending","lp","nft_lending","nft_liquidation","nft_mint","nft_sweep","nft_trade","nft_transfer","option","perp","reward","staking","sudo_pool","swap","transfer","wrap"]},"description":"The types of transactions to filter."},"chains":{"type":"array","items":{"type":"string"},"description":"The chains to filter."},"tokens":{"type":"array","items":{"type":"string"},"description":"The tokens to filter."},"min_usd_value":{"type":"number","description":"The minimum USD value to filter."}}}}}}
```

## The WebsocketEvent object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"WebsocketEvent":{"type":"object","oneOf":[{"$ref":"#/components/schemas/WebsocketTxEvent"},{"$ref":"#/components/schemas/WebsocketErrorEvent"}]},"WebsocketTxEvent":{"type":"object","properties":{"type":{"type":"string","description":"The type of event.","enum":["tx"]},"data":{"type":"object","oneOf":[{"$ref":"#/components/schemas/Swap"},{"$ref":"#/components/schemas/LP"},{"$ref":"#/components/schemas/Transfer"},{"$ref":"#/components/schemas/Lending"},{"$ref":"#/components/schemas/NftMint"},{"$ref":"#/components/schemas/NftTrade"},{"$ref":"#/components/schemas/NftTransfer"},{"$ref":"#/components/schemas/NftLending"},{"$ref":"#/components/schemas/Bridge"},{"$ref":"#/components/schemas/ContractInteraction"},{"$ref":"#/components/schemas/Wrap"},{"$ref":"#/components/schemas/SudoPool"},{"$ref":"#/components/schemas/Reward"},{"$ref":"#/components/schemas/Staking"},{"$ref":"#/components/schemas/Perp"},{"$ref":"#/components/schemas/Flashloan"},{"$ref":"#/components/schemas/ContractCreation"},{"$ref":"#/components/schemas/NftLiquidation"},{"$ref":"#/components/schemas/Option"},{"$ref":"#/components/schemas/NftSweep"}],"description":"The event data."}},"required":["type","data"]},"Swap":{"type":"object","description":"This object type provides detailed information about a cryptocurrency swap transaction. It includes critical details such as wallet addresses, transaction hash, type of swap, blockchain specifics, and timestamps. The structure outlines the specifics of the assets involved in the swap, including their addresses, names, symbols, amounts, and USD values. It is particularly useful for platforms tracking and analyzing DeFi swap transactions, offering insights into the trade's details, such as the decentralized exchange (DEX) used, the tokens exchanged, and their respective values. This comprehensive structure is ideal for users or systems needing a detailed view of swap transactions on blockchain networks.\n","properties":{"wallet":{"type":"string","description":"The wallet address that initiated the swap transaction."},"wallet_label":{"type":"string","description":"A readable label for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the swap transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, a token swap."},"chain":{"type":"string","description":"The blockchain network where the swap transaction occurred."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"dex":{"type":"string","description":"The decentralized exchange where the swap transaction took place."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction (often the same as the 'from' address in swap transactions)."},"token0_address":{"type":"string","description":"The address of the first token involved in the swap."},"token0_amount":{"type":"number","format":"double","description":"The amount of the first token involved in the swap."},"token0_amount_usd":{"type":"number","format":"double","description":"The USD value of the first token amount at the time of the swap."},"token0_name":{"type":"string","description":"The name of the first token involved in the swap."},"token0_price_usd":{"type":"number","format":"double","description":"The price of the first token in USD."},"token0_symbol":{"type":"string","description":"The symbol of the first token involved in the swap."},"token0_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"token1_address":{"type":"string","description":"The address of the second token involved in the swap."},"token1_amount":{"type":"number","format":"double","description":"The amount of the second token involved in the swap."},"token1_amount_usd":{"type":"number","format":"double","description":"The USD value of the second token amount at the time of the swap."},"token1_name":{"type":"string","description":"The name of the second token involved in the swap."},"token1_price_usd":{"type":"number","format":"double","description":"The price of the second token in USD."},"token1_symbol":{"type":"string","description":"The symbol of the second token involved in the swap."},"token1_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"first_interaction":{"type":"boolean","description":"Indicates whether this transaction was the first interaction between the involved wallet addresses."},"token_market_cap":{"type":"object","description":"Contains the market capitalization and liquidity details of the tokens involved in the swap transaction.","properties":{"token_address":{"type":"string","description":"The address of the token."},"market_cap":{"type":"number","format":"double","description":"The market capitalization of the token."},"liquidity":{"type":"number","format":"double","description":"The liquidity of the token."}},"required":["token_address","market_cap","liquidity"]},"is_sell":{"type":"boolean","description":"Indicates whether the swap transaction was a sell order."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","dex","from","to","token0_address","token0_amount","token0_amount_usd","token0_name","token0_price_usd","token0_symbol","token0_icon_link","token1_address","token1_amount","token1_amount_usd","token1_name","token1_price_usd","token1_symbol","token1_icon_link","first_interaction","is_sell"]},"LP":{"type":"object","description":"This object provides a comprehensive overview of a liquidity pool (LP) transaction on a decentralized exchange (DEX). It includes details about the wallet involved, the transaction hash, type, and associated blockchain, as well as specific information about the assets involved in the transaction. This structure is particularly useful for platforms that track and analyze liquidity pool actions, such as adding or removing liquidity, offering insights into the specifics of each action, including the assets involved, their amounts in both the native token and USD value, and their respective prices in USD.\n","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"dex":{"type":"string","description":"The name of the decentralized exchange where the LP transaction occurred."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"type":{"type":"string","description":"Specifies the nature of the LP transaction, such as 'add' or 'remove'."},"token0_address":{"type":"string","description":"The address of the first token involved in the LP transaction."},"token0_amount":{"type":"number","format":"double","description":"The amount of the first token involved in the transaction."},"token0_amount_usd":{"type":"number","format":"double","description":"The USD value of the first token amount at the time of the transaction."},"token0_name":{"type":"string","description":"The name of the first token involved in the transaction."},"token0_price_usd":{"type":"number","format":"double","description":"The price of the first token in USD."},"token0_symbol":{"type":"string","description":"The symbol of the first token involved in the transaction."},"token0_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"token1_address":{"type":"string","description":"The address of the second token involved in the LP transaction."},"token1_amount":{"type":"number","format":"double","description":"The amount of the second token involved in the transaction."},"token1_amount_usd":{"type":"number","format":"double","description":"The USD value of the second token amount at the time of the transaction."},"token1_name":{"type":"string","description":"The name of the second token involved in the transaction."},"token1_price_usd":{"type":"number","format":"double","description":"The price of the second token in USD."},"token1_symbol":{"type":"string","description":"The symbol of the second token involved in the transaction."},"token1_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"lower_bound":{"type":"number","format":"double","description":"Indicates the lower bound of the price range for the LP position, relevant in certain types of liquidity pools."},"upper_bound":{"type":"number","format":"double","description":"Indicates the upper bound of the price range for the LP position, relevant in certain types of liquidity pools."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","dex","from","type","token0_address","token0_amount","token0_amount_usd","token0_name","token0_price_usd","token0_symbol","token0_icon_link","token1_address","token1_amount","token1_amount_usd","token1_name","token1_price_usd","token1_symbol","token1_icon_link","lower_bound","upper_bound"]},"Transfer":{"type":"object","description":"This object represents the details of a cryptocurrency transfer transaction. It includes essential information such as wallet addresses, transaction hash, type of transfer, blockchain details, and timestamps. The structure is particularly useful for tracking standard token transfers on blockchain networks, providing a comprehensive overview of the transaction, including the amount transferred in USD, the token's contract address, its name, and symbol. This detailed structure is ideal for users or systems requiring a thorough view of token transfer transactions, including the specifics of the token involved and the value of the transaction.\n","properties":{"wallet":{"type":"string","description":"The wallet address involved in the transfer transaction."},"wallet_label":{"type":"string","description":"A readable label for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the transfer transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, a token transfer."},"chain":{"type":"string","description":"The blockchain network where the transfer transaction occurred."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"from_label":{"type":"string","description":"A readable version of the 'from' wallet address."},"to_label":{"type":"string","description":"A readable version of the 'to' wallet address."},"amount_usd":{"type":"number","format":"double","description":"The USD value of the amount transferred in the transaction."},"contract_address":{"type":"string","description":"The blockchain address of the contract under which the token is registered."},"name":{"type":"string","description":"The name of the token being transferred."},"symbol":{"type":"string","description":"The symbol of the token being transferred."},"token_price_usd":{"type":"number","format":"double","description":"The price of the token in USD at the time of the transaction."},"type":{"type":"string","description":"Indicates the contract standard of the token, such as ERC20."},"token_icon_link":{"type":"string","description":"A URL link to the token's icon image."},"token_market_cap":{"type":"object","description":"Contains the market capitalization and liquidity details of the tokens involved in the swap transaction.","properties":{"token_address":{"type":"string","description":"The address of the token."},"market_cap":{"type":"number","format":"double","description":"The market capitalization of the token."},"liquidity":{"type":"number","format":"double","description":"The liquidity of the token."}},"required":["token_address","market_cap","liquidity"]},"mempool":{"type":"boolean","description":"For Bitcoin transactions, this field indicates whether the transaction is in the mempool."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","from_label","to_label","amount_usd","contract_address","name","symbol","token_price_usd","type","token_icon_link"]},"Lending":{"type":"object","description":"This object represents the data structure for a specific transaction related to decentralized finance (DeFi) activities such as lending, borrowing, and other related actions. It provides detailed information about the transaction, including wallet addresses, transaction hash, type of transaction, chain details, and financial figures. This structure is particularly useful for platforms tracking DeFi activities, offering insights into the specifics of each transaction, such as the asset involved, the amount, the health factor in lending platforms, and the price of the asset in USD at the time of the transaction.\n","properties":{"wallet":{"type":"string","description":"The wallet address associated with the transaction."},"wallet_label":{"type":"string","description":"A more readable, shortened version of the wallet address."},"tx_hash":{"type":"string","description":"The unique identifier of the transaction, represented as a hash."},"tx_type":{"type":"string","description":"Specifies the type of DeFi transaction, such as lending, borrowing, etc."},"chain":{"type":"string","description":"Indicates the blockchain network on which the transaction occurred."},"index":{"type":"integer","description":"A sequential index or identifier for the transaction within a particular dataset or list."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number in the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"from_label":{"type":"string","description":"A readable, abbreviated form of the 'from' wallet address."},"action":{"type":"string","description":"Describes the action taken in the transaction, such as 'Repaid' in a lending scenario."},"address":{"type":"string","description":"The smart contract address involved in the transaction."},"amount":{"type":"number","format":"double","description":"The amount of the asset involved in the transaction."},"amount_usd":{"type":"number","format":"double","description":"The equivalent value of the transaction amount in USD."},"dex":{"type":"string","description":"The decentralized exchange or platform where the transaction occurred, such as AaveV2."},"health_factor":{"type":"number","format":"double","description":"A metric specific to lending platforms, indicating the health of the loan or position."},"name":{"type":"string","description":"The name of the asset involved in the transaction."},"platform":{"type":"string","description":"The DeFi platform associated with the transaction, like AaveV3."},"price_usd":{"type":"number","format":"double","description":"The price of the asset in USD at the time of the transaction."},"symbol":{"type":"string","description":"The symbol of the asset involved in the transaction."},"token_icon_link":{"type":"string","description":"A URL link to the icon image of the token involved in the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","from_label","action","address","amount","amount_usd","dex","health_factor","name","platform","price_usd","symbol","token_icon_link"]},"NftMint":{"type":"object","description":"This object represents the data structure for a Non-Fungible Token (NFT) minting transaction. It provides detailed information about the transaction, including wallet addresses, transaction hash, the type of NFT transaction (in this case, minting), and blockchain specifics. Additionally, it includes detailed information about the NFT minted, such as its image, contract address, token ID, and associated fees. This structure is particularly useful for platforms tracking NFT minting activities, offering insights into the creation of new NFTs, their associated costs, and the blockchain details.\n","properties":{"wallet":{"type":"string","description":"The wallet address involved in the NFT minting transaction."},"wallet_label":{"type":"string","description":"A more readable label or identifier for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the NFT minting transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, NFT minting."},"chain":{"type":"string","description":"The blockchain network on which the minting transaction was conducted."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"from_label":{"type":"string","description":"A readable version of the 'from' wallet address."},"to_label":{"type":"string","description":"A readable version of the 'to' wallet address."},"thumbnail":{"type":"string","description":"A thumbnail image URL of the NFT involved in the transaction."},"image":{"type":"string","description":"A full image URL of the NFT."},"amount":{"type":"number","format":"double","description":"The number of items of the NFT minted in the transaction."},"contract_address":{"type":"string","description":"The blockchain address of the contract under which the NFT is minted."},"contract_type":{"type":"string","description":"The type of contract used for the NFT, such as ERC721."},"fee":{"type":"number","format":"double","description":"The transaction fee incurred for minting the NFT."},"nft_name":{"type":"string","description":"The name of the NFT minted."},"nft_symbol":{"type":"string","description":"The symbol associated with the NFT."},"nft_token_id":{"type":"string","description":"The unique token ID of the minted NFT."},"currency_symbol":{"type":"string","description":"The symbol of the currency used in the transaction (e.g., ETH, MATIC)."},"type":{"type":"string","description":"Indicates the contract standard of the NFT, such as ERC721."},"value":{"type":"number","format":"double","description":"The value of the transaction. For minting, this is often zero since the NFT is being created."},"value_usd":{"type":"number","format":"double","description":"The equivalent USD value of the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","from_label","to_label","thumbnail","image","amount","contract_address","contract_type","fee","nft_name","nft_symbol","nft_token_id","currency_symbol","type","value","value_usd"]},"NftTrade":{"type":"object","description":"This object encapsulates the details of a Non-Fungible Token (NFT) trading transaction. It includes comprehensive information such as wallet addresses, transaction hash, type of transaction (NFT trade), blockchain details, and timestamps. The structure provides specific data about the NFT trade, including the NFT's image, contract address, marketplace of the trade, and price details in both cryptocurrency and USD. Additionally, it includes information about the buyer, seller, and whether the transaction involved a bid being accepted. This structure is ideal for platforms that monitor and analyze NFT trading activities, offering detailed insights into each trade, its valuation, and the parties involved.\n","properties":{"wallet":{"type":"string","description":"The wallet address involved in the NFT trading transaction."},"wallet_label":{"type":"string","description":"A readable label for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the NFT trading transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, NFT trading."},"chain":{"type":"string","description":"The blockchain network where the trading transaction occurred."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"thumbnail":{"type":"string","description":"A thumbnail image URL of the NFT involved in the transaction."},"image":{"type":"string","description":"A full image URL of the NFT."},"action":{"type":"string","description":"Describes the action taken in the NFT trade, such as 'buy' or 'sell'."},"contract":{"type":"string","description":"The blockchain contract address associated with the NFT."},"marketplace":{"type":"string","description":"The marketplace where the NFT trade occurred, such as OpenSea."},"nft_address":{"type":"string","description":"The blockchain address of the NFT involved in the trade."},"nft_name":{"type":"string","description":"The name of the NFT traded."},"nft_symbol":{"type":"string","description":"The symbol associated with the NFT."},"nft_token_id":{"type":"string","description":"The unique token ID of the NFT involved in the trade."},"price":{"type":"number","format":"double","description":"The price at which the NFT was traded."},"price_usd":{"type":"number","format":"double","description":"The equivalent USD value of the NFT trade."},"profit":{"type":"number","format":"double","description":"The profit earned from the trade. This may be zero in some transactions."},"currency_symbol":{"type":"string","description":"The symbol of the currency used in the trade, such as WETH or ETH."},"buyer":{"type":"string","description":"The wallet address of the buyer in the trade."},"seller":{"type":"string","description":"The wallet address of the seller in the trade."},"token":{"type":"string","description":"The token type used in the transaction."},"first_interaction":{"type":"boolean","description":"Indicates whether this was the first interaction between the buyer and seller."},"bid_accepted":{"type":"boolean","description":"Specifies if the transaction involved a bid being accepted."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","thumbnail","image","action","contract","marketplace","nft_address","nft_name","nft_symbol","nft_token_id","price","price_usd","profit","currency_symbol","buyer","seller","token","first_interaction","bid_accepted"]},"NftTransfer":{"type":"object","description":"This object type details a Non-Fungible Token (NFT) transfer transaction. It includes essential information such as wallet addresses, transaction hash, NFT details, and blockchain specifics. This structure is particularly useful for tracking NFT transfers, providing a complete overview of the transaction, including the involved parties (from and to addresses), the NFT's contract details, and the transaction's metadata such as timestamps and blockchain network. The object also includes the NFT's image, name, symbol, and token ID, offering a comprehensive view of the NFT being transferred.\n","properties":{"wallet":{"type":"string","description":"The wallet address involved in the NFT transfer transaction."},"wallet_label":{"type":"string","description":"A readable label for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the NFT transfer transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, NFT transfer."},"chain":{"type":"string","description":"The blockchain network where the transfer transaction occurred."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"from_label":{"type":"string","description":"A readable version of the 'from' wallet address."},"to_label":{"type":"string","description":"A readable version of the 'to' wallet address."},"thumbnail":{"type":"string","description":"A thumbnail image URL of the NFT involved in the transaction."},"image":{"type":"string","description":"A full image URL of the NFT."},"contract_address":{"type":"string","description":"The blockchain address of the contract under which the NFT is registered."},"contract_type":{"type":"string","description":"The type of contract used for the NFT, such as ERC721."},"fee":{"type":"number","format":"double","description":"The transaction fee incurred for the transfer of the NFT."},"nft_name":{"type":"string","description":"The name of the NFT being transferred."},"nft_symbol":{"type":"string","description":"The symbol associated with the NFT."},"nft_token_id":{"type":"string","description":"The unique token ID of the NFT involved in the transfer."},"type":{"type":"string","description":"Indicates the contract standard of the NFT, such as ERC721."},"value":{"type":"number","format":"double","description":"The value of the NFT at the time of the transfer. This might be represented in the native cryptocurrency of the blockchain."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","from_label","to_label","thumbnail","image","contract_address","contract_type","fee","nft_name","nft_symbol","nft_token_id","type","value"]},"NftLending":{"type":"object","description":"This object encapsulates detailed information about a Non-Fungible Token (NFT) lending transaction. It includes comprehensive details such as wallet addresses, transaction hash, the type of NFT transaction, the blockchain used, and timestamps. Additionally, it provides specifics about the NFT involved, including its address, name, symbol, image, and the terms of the lending agreement. This structure is particularly useful for platforms that need to track and manage NFT lending activities, providing all necessary details for analyzing and processing such transactions.\n","properties":{"wallet":{"type":"string","description":"The wallet address involved in the NFT lending transaction."},"wallet_label":{"type":"string","description":"A more readable label or identifier for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the NFT lending transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, NFT lending."},"chain":{"type":"string","description":"The blockchain network on which the transaction was conducted."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"from_label":{"type":"string","description":"A readable version of the 'from' wallet address."},"to_label":{"type":"string","description":"A readable version of the 'to' wallet address."},"thumbnail":{"type":"string","description":"A thumbnail image URL of the NFT involved in the transaction."},"image":{"type":"string","description":"A full image URL of the NFT."},"action":{"type":"string","description":"Describes the action taken in the NFT lending transaction, such as 'buy', 'lend', etc."},"currency_address":{"type":"string","description":"The blockchain address of the currency used in the transaction."},"currency_symbol":{"type":"string","description":"The symbol of the currency used in the transaction."},"interest":{"type":"number","format":"double","description":"The interest rate applied in the NFT lending transaction."},"nft_address":{"type":"string","description":"The blockchain address of the NFT involved in the transaction."},"nft_name":{"type":"string","description":"The name of the NFT."},"nft_symbol":{"type":"string","description":"The symbol of the NFT."},"platform":{"type":"string","description":"The platform or service through which the NFT lending transaction was conducted."},"nft_token_id":{"type":"string","description":"The unique identifier for the specific NFT within its collection."},"price":{"type":"number","format":"double","description":"The price at which the NFT was lent or transacted."},"price_usd":{"type":"number","format":"double","description":"The equivalent USD value of the transaction price."},"terms":{"type":"number","format":"double","description":"Specifies the terms of the NFT lending agreement."},"refinance":{"type":"boolean","description":"Indicates whether the transaction involved refinancing of the NFT."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","from_label","to_label","thumbnail","image","action","currency_address","currency_symbol","interest","nft_address","nft_name","nft_symbol","platform","nft_token_id","price","price_usd","terms","refinance"]},"Bridge":{"type":"object","description":"This object represents a detailed structure for a blockchain transaction, encompassing various aspects like wallet addresses, transaction hash, type, associated chains, and financial details. It is designed to provide a comprehensive view of a transaction, including the wallets involved, the transaction's nature, the chains it spans, and the financial details like the amount and its equivalent in USD. This structure is ideal for applications that require detailed tracking and analysis of blockchain transactions.\n","properties":{"wallet":{"type":"string","description":"The wallet address involved in the transaction."},"wallet_label":{"type":"string","description":"A shortened, more readable version of the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the transaction."},"tx_type":{"type":"string","description":"The type of transaction."},"chain":{"type":"string","description":"The blockchain on which the transaction occurred, like 'ethereum'."},"index":{"type":"integer","description":"A numeric index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp when the transaction occurred."},"block":{"type":"integer","description":"The block number on the blockchain in which the transaction is included."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"from_label":{"type":"string","description":"A shortened, more readable version of the originating wallet address."},"to_label":{"type":"string","description":"A shortened, more readable version of the destination wallet address."},"token_address":{"type":"string","description":"The address of the token involved in the transaction."},"token_name":{"type":"string","description":"The name of the token involved in the transaction."},"token_symbol":{"type":"string","description":"The symbol of the token involved in the transaction."},"token_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"amount":{"type":"number","format":"double","description":"The amount of the token involved in the transaction."},"amount_usd":{"type":"number","format":"double","description":"The equivalent amount in USD of the tokens involved in the transaction."},"from_chain":{"type":"string","description":"The originating chain of the transaction, in cases of cross-chain activities."},"to_chain":{"type":"string","description":"The destination chain of the transaction, in cases of cross-chain activities."},"platform":{"type":"string","description":"The platform or service used for the transaction."},"price":{"type":"number","format":"double","description":"The price of the token at the time of the transaction."},"type":{"type":"string","description":"Specifies the nature of the transaction, like 'withdraw', 'deposit', etc."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","from_label","to_label","token_address","token_name","token_symbol","amount","amount_usd","from_chain","to_chain","platform","price","type","token_icon_link"]},"ContractInteraction":{"type":"object","description":"This object provides a structure for representing a contract interaction event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"contract_address":{"type":"string","description":"The address of the smart contract involved in the interaction."},"contract_label":{"type":"string","description":"A human-readable label or name associated with the smart contract."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","contract_address","contract_label"]},"Wrap":{"type":"object","description":"This object provides a structure for representing a wrap event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"dex":{"type":"string","description":"The decentralized exchange where the wrap transaction occurred."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"action":{"type":"string"},"amount":{"type":"number","description":"The amount of tokens wrapped in the transaction."},"amount_usd":{"type":"number","description":"The equivalent amount in USD of the wrapped tokens."},"contract_address":{"type":"string","description":"The address of the smart contract involved in the interaction."},"name":{"type":"string","description":"The name of the token wrapped in the transaction."},"symbol":{"type":"string","description":"The symbol of the token wrapped in the transaction."},"token_price_usd":{"type":"number","description":"The price of the token in USD at the time of the transaction."},"token_type":{"type":"string","description":"The type of token wrapped in the transaction."},"token_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","dex","from","to","action","amount","amount_usd","contract_address","name","symbol","token_price_usd","token_type","token_icon_link"]},"SudoPool":{"type":"object","description":"This object provides a structure for representing a Sudo Pool event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"dex":{"type":"string","description":"The decentralized exchange where the wrap transaction occurred."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"nft_address":{"type":"string","description":"The address of the NFT contract involved in the interaction."},"nft_amount":{"type":"integer","description":"The amount of NFTs involved in the transaction."},"nft_price":{"type":"number","description":"The price of the NFT in the transaction."},"nft_symbol":{"type":"string","description":"The symbol of the NFT in the transaction."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"token0_address":{"type":"string","description":"The address of the first token in the LP pair."},"token0_amount":{"type":"number","description":"The amount of the first token in the LP pair."},"token0_amount_usd":{"type":"number","description":"The equivalent amount in USD of the first token in the LP pair."},"token0_name":{"type":"string","description":"The name of the first token in the LP pair."},"token0_price_usd":{"type":"number","description":"The price of the first token in the LP pair in USD."},"token0_symbol":{"type":"string","description":"The symbol of the first token in the LP pair."},"token0_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","nft_address","nft_amount","nft_price","nft_symbol","token0_address","token0_amount","token0_amount_usd","token0_name","token0_price_usd","token0_symbol","from","to","token0_icon_link"]},"Reward":{"type":"object","description":"This object provides a structure for representing a reward event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"address":{"type":"string","description":"The address of the token involved in the transaction."},"amount":{"type":"number","description":"The amount of tokens involved in the transaction."},"amount_usd":{"type":"number","description":"The equivalent amount in USD of the tokens involved in the transaction."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"name":{"type":"string","description":"The name of the token involved in the transaction."},"price_usd":{"type":"number","description":"The price of the token in USD."},"symbol":{"type":"string","description":"The symbol of the token involved in the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","address","amount","amount_usd","from","name","price_usd","symbol"]},"Staking":{"type":"object","description":"This object provides a structure for representing a staking event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"from_label":{"type":"string","description":"A human-readable label or name associated with the originating wallet."},"to_label":{"type":"string","description":"A human-readable label or name associated with the destination wallet."},"amount":{"type":"number","description":"The amount of tokens staked in the transaction."},"amount_usd":{"type":"number","description":"The equivalent amount in USD of the staked tokens."},"token_price_usd":{"type":"number","description":"The price of the token in USD."},"contract_address":{"type":"string","description":"The address of the smart contract involved in the interaction."},"symbol":{"type":"string","description":"The symbol of the token staked in the transaction."},"name":{"type":"string","description":"The name of the token staked in the transaction."},"action":{"type":"string","description":"The action taken in the staking transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","from_label","to_label","amount","amount_usd","token_price_usd","contract_address","symbol","name","action"]},"Perp":{"type":"object","description":"This object provides a structure for representing a Perpetual event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"action":{"type":"string","description":"The action taken in the Perpetual event."},"amount_usd":{"type":"number","description":"The equivalent amount in USD of the tokens involved in the transaction."},"average_price":{"type":"number","description":"The average price of the tokens involved in the transaction."},"base_token_address":{"type":"string","description":"The address of the base token involved in the transaction."},"base_token_amount":{"type":"number","description":"The amount of base tokens involved in the transaction."},"base_token_symbol":{"type":"string","description":"The symbol of the base token involved in the transaction."},"dex":{"type":"string","description":"The decentralized exchange where the Perpetual transaction occurred."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"liquidation":{"type":"boolean","description":"Indicates whether the transaction was a liquidation."},"liquidation_price":{"type":"number","description":"The price at which the liquidation occurred."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"trade_direction":{"type":"string","description":"The direction of the trade in the Perpetual transaction."},"perp_details":{"type":"string","description":"Additional details about the Perpetual transaction."},"token0_address":{"type":"string","description":"The address of the first token in the LP pair."},"token0_amount":{"type":"number","description":"The amount of the first token in the LP pair."},"token0_amount_usd":{"type":"number","description":"The equivalent amount in USD of the first token in the LP pair."},"token0_name":{"type":"string","description":"The name of the first token in the LP pair."},"token0_price_usd":{"type":"number","description":"The price of the first token in the LP pair in USD."},"token0_symbol":{"type":"string","description":"The symbol of the first token in the LP pair."},"token0_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"token1_address":{"type":"string","description":"The address of the second token in the LP pair."},"token1_amount":{"type":"number","description":"The amount of the second token in the LP pair."},"token1_amount_usd":{"type":"number","description":"The equivalent amount in USD of the second token in the LP pair."},"token1_name":{"type":"string","description":"The name of the second token in the LP pair."},"token1_price_usd":{"type":"number","description":"The price of the second token in the LP pair in USD."},"token1_symbol":{"type":"string","description":"The symbol of the second token in the LP pair."},"token1_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"realized_pnl":{"type":"number","description":"The realized profit and loss of the Perpetual transaction."},"is_nft_perp":{"type":"boolean","description":"Indicates whether the Perpetual transaction involves an NFT."},"position_size":{"type":"number","description":"The size of the position in the Perpetual transaction."},"position_size_usd":{"type":"number","description":"The equivalent amount in USD of the position size."},"leverage":{"type":"number","description":"The leverage used in the Perpetual transaction."},"unrealized_pnl":{"type":"number","description":"The unrealized profit and loss of the Perpetual transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","action","amount_usd","average_price","base_token_address","base_token_amount","base_token_symbol","dex","from","liquidation","liquidation_price","to","trade_direction","perp_details","token0_address","token0_amount","token0_amount_usd","token0_name","token0_price_usd","token0_symbol","token0_icon_link","token1_address","token1_amount","token1_amount_usd","token1_name","token1_price_usd","token1_symbol","token1_icon_link","realized_pnl","is_nft_perp"]},"Flashloan":{"type":"object","description":"This object provides a structure for representing a flashloan event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"address":{"type":"string","description":"The address of the token involved in the transaction."},"amount":{"type":"number","description":"The amount of tokens involved in the transaction."},"amount_usd":{"type":"number","description":"The equivalent amount in USD of the tokens involved in the transaction."},"dex":{"type":"string","description":"The decentralized exchange (DEX) where the flashloan transaction took place."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"health_factor":{"type":"number","description":"The health factor of the wallet after the flashloan transaction."},"name":{"type":"string","description":"The name of the token involved in the transaction."},"platform":{"type":"string","description":"The platform where the flashloan transaction took place."},"price_usd":{"type":"number","description":"The price of the token in USD."},"symbol":{"type":"string","description":"The symbol of the token involved in the transaction."},"token_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","address","amount","amount_usd","dex","from","health_factor","name","platform","price_usd","symbol","token_icon_link"]},"ContractCreation":{"type":"object","description":"This object provides a structure for representing a contract creation event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"amount_usd":{"type":"number","description":"The equivalent amount in USD of the wrapped tokens."},"contract_address":{"type":"string","description":"The address of the smart contract involved in the interaction."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"from_label":{"type":"string","description":"A human-readable label or name associated with the originating wallet."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","amount_usd","contract_address","from","from_label"]},"NftLiquidation":{"type":"object","description":"This object provides a structure for representing a NFT liquidation event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"contract_address":{"type":"string","description":"The address of the NFT contract involved in the interaction."},"currency_address":{"type":"string","description":"The address of the currency involved in the transaction."},"currency_symbol":{"type":"string","description":"The symbol of the currency involved in the transaction."},"dex":{"type":"string","description":"The decentralized exchange where the wrap transaction occurred."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"nft_address":{"type":"string","description":"The address of the NFT contract involved in the interaction."},"nft_name":{"type":"string","description":"The name of the NFT in the transaction."},"nft_symbol":{"type":"string","description":"The symbol of the NFT in the transaction."},"platform":{"type":"string","description":"The platform where the flashloan transaction took place."},"price":{"type":"number","description":"The price of the NFT in the transaction."},"price_usd":{"type":"number","description":"The price of the NFT in USD."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"token_id":{"type":"string","description":"The unique identifier of the NFT in the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","contract_address","currency_address","currency_symbol","dex","from","nft_address","nft_name","nft_symbol","platform","price","price_usd","to","token_id"]},"Option":{"type":"object","description":"This object provides a structure for representing an option event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"action":{"type":"string","description":"The action taken in the option event."},"amount":{"type":"number","description":"The amount of tokens involved in the transaction."},"asset":{"type":"string","description":"The asset involved in the option event."},"dex":{"type":"string","description":"The decentralized exchange (DEX) where the option event took place."},"direction":{"type":"string","description":"The direction of the option event."},"expiry":{"type":"string","description":"The expiry date of the option."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"option_price_usd":{"type":"number","description":"The price of the option in USD."},"position_status":{"type":"string","description":"The status of the option position."},"spot_price_usd":{"type":"number","description":"The spot price of the asset in USD."},"status":{"type":"string","description":"The status of the option event."},"strike_price_usd":{"type":"number","description":"The strike price of the option in USD."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"type":{"type":"string","description":"The type of option event."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","action","amount","asset","dex","direction","expiry","from","option_price_usd","position_status","spot_price_usd","status","strike_price_usd","to","type"]},"NftSweep":{"type":"object","description":"This object provides a structure for representing a NFT sweep event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address involved in the NFT trading transaction."},"wallet_label":{"type":"string","description":"A readable label for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the NFT trading transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, NFT trading."},"chain":{"type":"string","description":"The blockchain network where the trading transaction occurred."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"thumbnail":{"type":"string","description":"A thumbnail image URL of the NFT involved in the transaction."},"image":{"type":"string","description":"A full image URL of the NFT."},"action":{"type":"string","description":"Describes the action taken in the NFT trade, such as 'buy' or 'sell'."},"contract":{"type":"string","description":"The blockchain contract address associated with the NFT."},"marketplace":{"type":"string","description":"The marketplace where the NFT trade occurred, such as OpenSea."},"nft_address":{"type":"string","description":"The blockchain address of the NFT involved in the trade."},"nft_name":{"type":"string","description":"The name of the NFT traded."},"nft_symbol":{"type":"string","description":"The symbol associated with the NFT."},"nft_token_id":{"type":"string","description":"The unique token ID of the NFT involved in the trade."},"price":{"type":"number","format":"double","description":"The price at which the NFT was traded."},"price_usd":{"type":"number","format":"double","description":"The equivalent USD value of the NFT trade."},"profit":{"type":"number","format":"double","description":"The profit earned from the trade. This may be zero in some transactions."},"currency_symbol":{"type":"string","description":"The symbol of the currency used in the trade, such as WETH or ETH."},"buyer":{"type":"string","description":"The wallet address of the buyer in the trade."},"seller":{"type":"string","description":"The wallet address of the seller in the trade."},"token":{"type":"string","description":"The token type used in the transaction."},"first_interaction":{"type":"boolean","description":"Indicates whether this was the first interaction between the buyer and seller."},"bid_accepted":{"type":"boolean","description":"Specifies if the transaction involved a bid being accepted."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","thumbnail","image","action","contract","marketplace","nft_address","nft_name","nft_symbol","nft_token_id","price","price_usd","profit","currency_symbol","buyer","seller","token","first_interaction","bid_accepted"]},"WebsocketErrorEvent":{"type":"object","properties":{"type":{"type":"string","enum":["error"]},"data":{"type":"string","description":"The error message."}},"required":["type","data"]}}}}
```

## The WebsocketTxEvent object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"WebsocketTxEvent":{"type":"object","properties":{"type":{"type":"string","description":"The type of event.","enum":["tx"]},"data":{"type":"object","oneOf":[{"$ref":"#/components/schemas/Swap"},{"$ref":"#/components/schemas/LP"},{"$ref":"#/components/schemas/Transfer"},{"$ref":"#/components/schemas/Lending"},{"$ref":"#/components/schemas/NftMint"},{"$ref":"#/components/schemas/NftTrade"},{"$ref":"#/components/schemas/NftTransfer"},{"$ref":"#/components/schemas/NftLending"},{"$ref":"#/components/schemas/Bridge"},{"$ref":"#/components/schemas/ContractInteraction"},{"$ref":"#/components/schemas/Wrap"},{"$ref":"#/components/schemas/SudoPool"},{"$ref":"#/components/schemas/Reward"},{"$ref":"#/components/schemas/Staking"},{"$ref":"#/components/schemas/Perp"},{"$ref":"#/components/schemas/Flashloan"},{"$ref":"#/components/schemas/ContractCreation"},{"$ref":"#/components/schemas/NftLiquidation"},{"$ref":"#/components/schemas/Option"},{"$ref":"#/components/schemas/NftSweep"}],"description":"The event data."}},"required":["type","data"]},"Swap":{"type":"object","description":"This object type provides detailed information about a cryptocurrency swap transaction. It includes critical details such as wallet addresses, transaction hash, type of swap, blockchain specifics, and timestamps. The structure outlines the specifics of the assets involved in the swap, including their addresses, names, symbols, amounts, and USD values. It is particularly useful for platforms tracking and analyzing DeFi swap transactions, offering insights into the trade's details, such as the decentralized exchange (DEX) used, the tokens exchanged, and their respective values. This comprehensive structure is ideal for users or systems needing a detailed view of swap transactions on blockchain networks.\n","properties":{"wallet":{"type":"string","description":"The wallet address that initiated the swap transaction."},"wallet_label":{"type":"string","description":"A readable label for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the swap transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, a token swap."},"chain":{"type":"string","description":"The blockchain network where the swap transaction occurred."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"dex":{"type":"string","description":"The decentralized exchange where the swap transaction took place."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction (often the same as the 'from' address in swap transactions)."},"token0_address":{"type":"string","description":"The address of the first token involved in the swap."},"token0_amount":{"type":"number","format":"double","description":"The amount of the first token involved in the swap."},"token0_amount_usd":{"type":"number","format":"double","description":"The USD value of the first token amount at the time of the swap."},"token0_name":{"type":"string","description":"The name of the first token involved in the swap."},"token0_price_usd":{"type":"number","format":"double","description":"The price of the first token in USD."},"token0_symbol":{"type":"string","description":"The symbol of the first token involved in the swap."},"token0_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"token1_address":{"type":"string","description":"The address of the second token involved in the swap."},"token1_amount":{"type":"number","format":"double","description":"The amount of the second token involved in the swap."},"token1_amount_usd":{"type":"number","format":"double","description":"The USD value of the second token amount at the time of the swap."},"token1_name":{"type":"string","description":"The name of the second token involved in the swap."},"token1_price_usd":{"type":"number","format":"double","description":"The price of the second token in USD."},"token1_symbol":{"type":"string","description":"The symbol of the second token involved in the swap."},"token1_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"first_interaction":{"type":"boolean","description":"Indicates whether this transaction was the first interaction between the involved wallet addresses."},"token_market_cap":{"type":"object","description":"Contains the market capitalization and liquidity details of the tokens involved in the swap transaction.","properties":{"token_address":{"type":"string","description":"The address of the token."},"market_cap":{"type":"number","format":"double","description":"The market capitalization of the token."},"liquidity":{"type":"number","format":"double","description":"The liquidity of the token."}},"required":["token_address","market_cap","liquidity"]},"is_sell":{"type":"boolean","description":"Indicates whether the swap transaction was a sell order."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","dex","from","to","token0_address","token0_amount","token0_amount_usd","token0_name","token0_price_usd","token0_symbol","token0_icon_link","token1_address","token1_amount","token1_amount_usd","token1_name","token1_price_usd","token1_symbol","token1_icon_link","first_interaction","is_sell"]},"LP":{"type":"object","description":"This object provides a comprehensive overview of a liquidity pool (LP) transaction on a decentralized exchange (DEX). It includes details about the wallet involved, the transaction hash, type, and associated blockchain, as well as specific information about the assets involved in the transaction. This structure is particularly useful for platforms that track and analyze liquidity pool actions, such as adding or removing liquidity, offering insights into the specifics of each action, including the assets involved, their amounts in both the native token and USD value, and their respective prices in USD.\n","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"dex":{"type":"string","description":"The name of the decentralized exchange where the LP transaction occurred."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"type":{"type":"string","description":"Specifies the nature of the LP transaction, such as 'add' or 'remove'."},"token0_address":{"type":"string","description":"The address of the first token involved in the LP transaction."},"token0_amount":{"type":"number","format":"double","description":"The amount of the first token involved in the transaction."},"token0_amount_usd":{"type":"number","format":"double","description":"The USD value of the first token amount at the time of the transaction."},"token0_name":{"type":"string","description":"The name of the first token involved in the transaction."},"token0_price_usd":{"type":"number","format":"double","description":"The price of the first token in USD."},"token0_symbol":{"type":"string","description":"The symbol of the first token involved in the transaction."},"token0_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"token1_address":{"type":"string","description":"The address of the second token involved in the LP transaction."},"token1_amount":{"type":"number","format":"double","description":"The amount of the second token involved in the transaction."},"token1_amount_usd":{"type":"number","format":"double","description":"The USD value of the second token amount at the time of the transaction."},"token1_name":{"type":"string","description":"The name of the second token involved in the transaction."},"token1_price_usd":{"type":"number","format":"double","description":"The price of the second token in USD."},"token1_symbol":{"type":"string","description":"The symbol of the second token involved in the transaction."},"token1_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"lower_bound":{"type":"number","format":"double","description":"Indicates the lower bound of the price range for the LP position, relevant in certain types of liquidity pools."},"upper_bound":{"type":"number","format":"double","description":"Indicates the upper bound of the price range for the LP position, relevant in certain types of liquidity pools."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","dex","from","type","token0_address","token0_amount","token0_amount_usd","token0_name","token0_price_usd","token0_symbol","token0_icon_link","token1_address","token1_amount","token1_amount_usd","token1_name","token1_price_usd","token1_symbol","token1_icon_link","lower_bound","upper_bound"]},"Transfer":{"type":"object","description":"This object represents the details of a cryptocurrency transfer transaction. It includes essential information such as wallet addresses, transaction hash, type of transfer, blockchain details, and timestamps. The structure is particularly useful for tracking standard token transfers on blockchain networks, providing a comprehensive overview of the transaction, including the amount transferred in USD, the token's contract address, its name, and symbol. This detailed structure is ideal for users or systems requiring a thorough view of token transfer transactions, including the specifics of the token involved and the value of the transaction.\n","properties":{"wallet":{"type":"string","description":"The wallet address involved in the transfer transaction."},"wallet_label":{"type":"string","description":"A readable label for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the transfer transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, a token transfer."},"chain":{"type":"string","description":"The blockchain network where the transfer transaction occurred."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"from_label":{"type":"string","description":"A readable version of the 'from' wallet address."},"to_label":{"type":"string","description":"A readable version of the 'to' wallet address."},"amount_usd":{"type":"number","format":"double","description":"The USD value of the amount transferred in the transaction."},"contract_address":{"type":"string","description":"The blockchain address of the contract under which the token is registered."},"name":{"type":"string","description":"The name of the token being transferred."},"symbol":{"type":"string","description":"The symbol of the token being transferred."},"token_price_usd":{"type":"number","format":"double","description":"The price of the token in USD at the time of the transaction."},"type":{"type":"string","description":"Indicates the contract standard of the token, such as ERC20."},"token_icon_link":{"type":"string","description":"A URL link to the token's icon image."},"token_market_cap":{"type":"object","description":"Contains the market capitalization and liquidity details of the tokens involved in the swap transaction.","properties":{"token_address":{"type":"string","description":"The address of the token."},"market_cap":{"type":"number","format":"double","description":"The market capitalization of the token."},"liquidity":{"type":"number","format":"double","description":"The liquidity of the token."}},"required":["token_address","market_cap","liquidity"]},"mempool":{"type":"boolean","description":"For Bitcoin transactions, this field indicates whether the transaction is in the mempool."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","from_label","to_label","amount_usd","contract_address","name","symbol","token_price_usd","type","token_icon_link"]},"Lending":{"type":"object","description":"This object represents the data structure for a specific transaction related to decentralized finance (DeFi) activities such as lending, borrowing, and other related actions. It provides detailed information about the transaction, including wallet addresses, transaction hash, type of transaction, chain details, and financial figures. This structure is particularly useful for platforms tracking DeFi activities, offering insights into the specifics of each transaction, such as the asset involved, the amount, the health factor in lending platforms, and the price of the asset in USD at the time of the transaction.\n","properties":{"wallet":{"type":"string","description":"The wallet address associated with the transaction."},"wallet_label":{"type":"string","description":"A more readable, shortened version of the wallet address."},"tx_hash":{"type":"string","description":"The unique identifier of the transaction, represented as a hash."},"tx_type":{"type":"string","description":"Specifies the type of DeFi transaction, such as lending, borrowing, etc."},"chain":{"type":"string","description":"Indicates the blockchain network on which the transaction occurred."},"index":{"type":"integer","description":"A sequential index or identifier for the transaction within a particular dataset or list."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number in the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"from_label":{"type":"string","description":"A readable, abbreviated form of the 'from' wallet address."},"action":{"type":"string","description":"Describes the action taken in the transaction, such as 'Repaid' in a lending scenario."},"address":{"type":"string","description":"The smart contract address involved in the transaction."},"amount":{"type":"number","format":"double","description":"The amount of the asset involved in the transaction."},"amount_usd":{"type":"number","format":"double","description":"The equivalent value of the transaction amount in USD."},"dex":{"type":"string","description":"The decentralized exchange or platform where the transaction occurred, such as AaveV2."},"health_factor":{"type":"number","format":"double","description":"A metric specific to lending platforms, indicating the health of the loan or position."},"name":{"type":"string","description":"The name of the asset involved in the transaction."},"platform":{"type":"string","description":"The DeFi platform associated with the transaction, like AaveV3."},"price_usd":{"type":"number","format":"double","description":"The price of the asset in USD at the time of the transaction."},"symbol":{"type":"string","description":"The symbol of the asset involved in the transaction."},"token_icon_link":{"type":"string","description":"A URL link to the icon image of the token involved in the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","from_label","action","address","amount","amount_usd","dex","health_factor","name","platform","price_usd","symbol","token_icon_link"]},"NftMint":{"type":"object","description":"This object represents the data structure for a Non-Fungible Token (NFT) minting transaction. It provides detailed information about the transaction, including wallet addresses, transaction hash, the type of NFT transaction (in this case, minting), and blockchain specifics. Additionally, it includes detailed information about the NFT minted, such as its image, contract address, token ID, and associated fees. This structure is particularly useful for platforms tracking NFT minting activities, offering insights into the creation of new NFTs, their associated costs, and the blockchain details.\n","properties":{"wallet":{"type":"string","description":"The wallet address involved in the NFT minting transaction."},"wallet_label":{"type":"string","description":"A more readable label or identifier for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the NFT minting transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, NFT minting."},"chain":{"type":"string","description":"The blockchain network on which the minting transaction was conducted."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"from_label":{"type":"string","description":"A readable version of the 'from' wallet address."},"to_label":{"type":"string","description":"A readable version of the 'to' wallet address."},"thumbnail":{"type":"string","description":"A thumbnail image URL of the NFT involved in the transaction."},"image":{"type":"string","description":"A full image URL of the NFT."},"amount":{"type":"number","format":"double","description":"The number of items of the NFT minted in the transaction."},"contract_address":{"type":"string","description":"The blockchain address of the contract under which the NFT is minted."},"contract_type":{"type":"string","description":"The type of contract used for the NFT, such as ERC721."},"fee":{"type":"number","format":"double","description":"The transaction fee incurred for minting the NFT."},"nft_name":{"type":"string","description":"The name of the NFT minted."},"nft_symbol":{"type":"string","description":"The symbol associated with the NFT."},"nft_token_id":{"type":"string","description":"The unique token ID of the minted NFT."},"currency_symbol":{"type":"string","description":"The symbol of the currency used in the transaction (e.g., ETH, MATIC)."},"type":{"type":"string","description":"Indicates the contract standard of the NFT, such as ERC721."},"value":{"type":"number","format":"double","description":"The value of the transaction. For minting, this is often zero since the NFT is being created."},"value_usd":{"type":"number","format":"double","description":"The equivalent USD value of the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","from_label","to_label","thumbnail","image","amount","contract_address","contract_type","fee","nft_name","nft_symbol","nft_token_id","currency_symbol","type","value","value_usd"]},"NftTrade":{"type":"object","description":"This object encapsulates the details of a Non-Fungible Token (NFT) trading transaction. It includes comprehensive information such as wallet addresses, transaction hash, type of transaction (NFT trade), blockchain details, and timestamps. The structure provides specific data about the NFT trade, including the NFT's image, contract address, marketplace of the trade, and price details in both cryptocurrency and USD. Additionally, it includes information about the buyer, seller, and whether the transaction involved a bid being accepted. This structure is ideal for platforms that monitor and analyze NFT trading activities, offering detailed insights into each trade, its valuation, and the parties involved.\n","properties":{"wallet":{"type":"string","description":"The wallet address involved in the NFT trading transaction."},"wallet_label":{"type":"string","description":"A readable label for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the NFT trading transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, NFT trading."},"chain":{"type":"string","description":"The blockchain network where the trading transaction occurred."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"thumbnail":{"type":"string","description":"A thumbnail image URL of the NFT involved in the transaction."},"image":{"type":"string","description":"A full image URL of the NFT."},"action":{"type":"string","description":"Describes the action taken in the NFT trade, such as 'buy' or 'sell'."},"contract":{"type":"string","description":"The blockchain contract address associated with the NFT."},"marketplace":{"type":"string","description":"The marketplace where the NFT trade occurred, such as OpenSea."},"nft_address":{"type":"string","description":"The blockchain address of the NFT involved in the trade."},"nft_name":{"type":"string","description":"The name of the NFT traded."},"nft_symbol":{"type":"string","description":"The symbol associated with the NFT."},"nft_token_id":{"type":"string","description":"The unique token ID of the NFT involved in the trade."},"price":{"type":"number","format":"double","description":"The price at which the NFT was traded."},"price_usd":{"type":"number","format":"double","description":"The equivalent USD value of the NFT trade."},"profit":{"type":"number","format":"double","description":"The profit earned from the trade. This may be zero in some transactions."},"currency_symbol":{"type":"string","description":"The symbol of the currency used in the trade, such as WETH or ETH."},"buyer":{"type":"string","description":"The wallet address of the buyer in the trade."},"seller":{"type":"string","description":"The wallet address of the seller in the trade."},"token":{"type":"string","description":"The token type used in the transaction."},"first_interaction":{"type":"boolean","description":"Indicates whether this was the first interaction between the buyer and seller."},"bid_accepted":{"type":"boolean","description":"Specifies if the transaction involved a bid being accepted."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","thumbnail","image","action","contract","marketplace","nft_address","nft_name","nft_symbol","nft_token_id","price","price_usd","profit","currency_symbol","buyer","seller","token","first_interaction","bid_accepted"]},"NftTransfer":{"type":"object","description":"This object type details a Non-Fungible Token (NFT) transfer transaction. It includes essential information such as wallet addresses, transaction hash, NFT details, and blockchain specifics. This structure is particularly useful for tracking NFT transfers, providing a complete overview of the transaction, including the involved parties (from and to addresses), the NFT's contract details, and the transaction's metadata such as timestamps and blockchain network. The object also includes the NFT's image, name, symbol, and token ID, offering a comprehensive view of the NFT being transferred.\n","properties":{"wallet":{"type":"string","description":"The wallet address involved in the NFT transfer transaction."},"wallet_label":{"type":"string","description":"A readable label for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the NFT transfer transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, NFT transfer."},"chain":{"type":"string","description":"The blockchain network where the transfer transaction occurred."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"from_label":{"type":"string","description":"A readable version of the 'from' wallet address."},"to_label":{"type":"string","description":"A readable version of the 'to' wallet address."},"thumbnail":{"type":"string","description":"A thumbnail image URL of the NFT involved in the transaction."},"image":{"type":"string","description":"A full image URL of the NFT."},"contract_address":{"type":"string","description":"The blockchain address of the contract under which the NFT is registered."},"contract_type":{"type":"string","description":"The type of contract used for the NFT, such as ERC721."},"fee":{"type":"number","format":"double","description":"The transaction fee incurred for the transfer of the NFT."},"nft_name":{"type":"string","description":"The name of the NFT being transferred."},"nft_symbol":{"type":"string","description":"The symbol associated with the NFT."},"nft_token_id":{"type":"string","description":"The unique token ID of the NFT involved in the transfer."},"type":{"type":"string","description":"Indicates the contract standard of the NFT, such as ERC721."},"value":{"type":"number","format":"double","description":"The value of the NFT at the time of the transfer. This might be represented in the native cryptocurrency of the blockchain."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","from_label","to_label","thumbnail","image","contract_address","contract_type","fee","nft_name","nft_symbol","nft_token_id","type","value"]},"NftLending":{"type":"object","description":"This object encapsulates detailed information about a Non-Fungible Token (NFT) lending transaction. It includes comprehensive details such as wallet addresses, transaction hash, the type of NFT transaction, the blockchain used, and timestamps. Additionally, it provides specifics about the NFT involved, including its address, name, symbol, image, and the terms of the lending agreement. This structure is particularly useful for platforms that need to track and manage NFT lending activities, providing all necessary details for analyzing and processing such transactions.\n","properties":{"wallet":{"type":"string","description":"The wallet address involved in the NFT lending transaction."},"wallet_label":{"type":"string","description":"A more readable label or identifier for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the NFT lending transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, NFT lending."},"chain":{"type":"string","description":"The blockchain network on which the transaction was conducted."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"from_label":{"type":"string","description":"A readable version of the 'from' wallet address."},"to_label":{"type":"string","description":"A readable version of the 'to' wallet address."},"thumbnail":{"type":"string","description":"A thumbnail image URL of the NFT involved in the transaction."},"image":{"type":"string","description":"A full image URL of the NFT."},"action":{"type":"string","description":"Describes the action taken in the NFT lending transaction, such as 'buy', 'lend', etc."},"currency_address":{"type":"string","description":"The blockchain address of the currency used in the transaction."},"currency_symbol":{"type":"string","description":"The symbol of the currency used in the transaction."},"interest":{"type":"number","format":"double","description":"The interest rate applied in the NFT lending transaction."},"nft_address":{"type":"string","description":"The blockchain address of the NFT involved in the transaction."},"nft_name":{"type":"string","description":"The name of the NFT."},"nft_symbol":{"type":"string","description":"The symbol of the NFT."},"platform":{"type":"string","description":"The platform or service through which the NFT lending transaction was conducted."},"nft_token_id":{"type":"string","description":"The unique identifier for the specific NFT within its collection."},"price":{"type":"number","format":"double","description":"The price at which the NFT was lent or transacted."},"price_usd":{"type":"number","format":"double","description":"The equivalent USD value of the transaction price."},"terms":{"type":"number","format":"double","description":"Specifies the terms of the NFT lending agreement."},"refinance":{"type":"boolean","description":"Indicates whether the transaction involved refinancing of the NFT."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","from_label","to_label","thumbnail","image","action","currency_address","currency_symbol","interest","nft_address","nft_name","nft_symbol","platform","nft_token_id","price","price_usd","terms","refinance"]},"Bridge":{"type":"object","description":"This object represents a detailed structure for a blockchain transaction, encompassing various aspects like wallet addresses, transaction hash, type, associated chains, and financial details. It is designed to provide a comprehensive view of a transaction, including the wallets involved, the transaction's nature, the chains it spans, and the financial details like the amount and its equivalent in USD. This structure is ideal for applications that require detailed tracking and analysis of blockchain transactions.\n","properties":{"wallet":{"type":"string","description":"The wallet address involved in the transaction."},"wallet_label":{"type":"string","description":"A shortened, more readable version of the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the transaction."},"tx_type":{"type":"string","description":"The type of transaction."},"chain":{"type":"string","description":"The blockchain on which the transaction occurred, like 'ethereum'."},"index":{"type":"integer","description":"A numeric index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp when the transaction occurred."},"block":{"type":"integer","description":"The block number on the blockchain in which the transaction is included."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"from_label":{"type":"string","description":"A shortened, more readable version of the originating wallet address."},"to_label":{"type":"string","description":"A shortened, more readable version of the destination wallet address."},"token_address":{"type":"string","description":"The address of the token involved in the transaction."},"token_name":{"type":"string","description":"The name of the token involved in the transaction."},"token_symbol":{"type":"string","description":"The symbol of the token involved in the transaction."},"token_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"amount":{"type":"number","format":"double","description":"The amount of the token involved in the transaction."},"amount_usd":{"type":"number","format":"double","description":"The equivalent amount in USD of the tokens involved in the transaction."},"from_chain":{"type":"string","description":"The originating chain of the transaction, in cases of cross-chain activities."},"to_chain":{"type":"string","description":"The destination chain of the transaction, in cases of cross-chain activities."},"platform":{"type":"string","description":"The platform or service used for the transaction."},"price":{"type":"number","format":"double","description":"The price of the token at the time of the transaction."},"type":{"type":"string","description":"Specifies the nature of the transaction, like 'withdraw', 'deposit', etc."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","from_label","to_label","token_address","token_name","token_symbol","amount","amount_usd","from_chain","to_chain","platform","price","type","token_icon_link"]},"ContractInteraction":{"type":"object","description":"This object provides a structure for representing a contract interaction event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"contract_address":{"type":"string","description":"The address of the smart contract involved in the interaction."},"contract_label":{"type":"string","description":"A human-readable label or name associated with the smart contract."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","contract_address","contract_label"]},"Wrap":{"type":"object","description":"This object provides a structure for representing a wrap event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"dex":{"type":"string","description":"The decentralized exchange where the wrap transaction occurred."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"action":{"type":"string"},"amount":{"type":"number","description":"The amount of tokens wrapped in the transaction."},"amount_usd":{"type":"number","description":"The equivalent amount in USD of the wrapped tokens."},"contract_address":{"type":"string","description":"The address of the smart contract involved in the interaction."},"name":{"type":"string","description":"The name of the token wrapped in the transaction."},"symbol":{"type":"string","description":"The symbol of the token wrapped in the transaction."},"token_price_usd":{"type":"number","description":"The price of the token in USD at the time of the transaction."},"token_type":{"type":"string","description":"The type of token wrapped in the transaction."},"token_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","dex","from","to","action","amount","amount_usd","contract_address","name","symbol","token_price_usd","token_type","token_icon_link"]},"SudoPool":{"type":"object","description":"This object provides a structure for representing a Sudo Pool event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"dex":{"type":"string","description":"The decentralized exchange where the wrap transaction occurred."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"nft_address":{"type":"string","description":"The address of the NFT contract involved in the interaction."},"nft_amount":{"type":"integer","description":"The amount of NFTs involved in the transaction."},"nft_price":{"type":"number","description":"The price of the NFT in the transaction."},"nft_symbol":{"type":"string","description":"The symbol of the NFT in the transaction."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"token0_address":{"type":"string","description":"The address of the first token in the LP pair."},"token0_amount":{"type":"number","description":"The amount of the first token in the LP pair."},"token0_amount_usd":{"type":"number","description":"The equivalent amount in USD of the first token in the LP pair."},"token0_name":{"type":"string","description":"The name of the first token in the LP pair."},"token0_price_usd":{"type":"number","description":"The price of the first token in the LP pair in USD."},"token0_symbol":{"type":"string","description":"The symbol of the first token in the LP pair."},"token0_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","nft_address","nft_amount","nft_price","nft_symbol","token0_address","token0_amount","token0_amount_usd","token0_name","token0_price_usd","token0_symbol","from","to","token0_icon_link"]},"Reward":{"type":"object","description":"This object provides a structure for representing a reward event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"address":{"type":"string","description":"The address of the token involved in the transaction."},"amount":{"type":"number","description":"The amount of tokens involved in the transaction."},"amount_usd":{"type":"number","description":"The equivalent amount in USD of the tokens involved in the transaction."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"name":{"type":"string","description":"The name of the token involved in the transaction."},"price_usd":{"type":"number","description":"The price of the token in USD."},"symbol":{"type":"string","description":"The symbol of the token involved in the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","address","amount","amount_usd","from","name","price_usd","symbol"]},"Staking":{"type":"object","description":"This object provides a structure for representing a staking event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"from_label":{"type":"string","description":"A human-readable label or name associated with the originating wallet."},"to_label":{"type":"string","description":"A human-readable label or name associated with the destination wallet."},"amount":{"type":"number","description":"The amount of tokens staked in the transaction."},"amount_usd":{"type":"number","description":"The equivalent amount in USD of the staked tokens."},"token_price_usd":{"type":"number","description":"The price of the token in USD."},"contract_address":{"type":"string","description":"The address of the smart contract involved in the interaction."},"symbol":{"type":"string","description":"The symbol of the token staked in the transaction."},"name":{"type":"string","description":"The name of the token staked in the transaction."},"action":{"type":"string","description":"The action taken in the staking transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","from_label","to_label","amount","amount_usd","token_price_usd","contract_address","symbol","name","action"]},"Perp":{"type":"object","description":"This object provides a structure for representing a Perpetual event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"action":{"type":"string","description":"The action taken in the Perpetual event."},"amount_usd":{"type":"number","description":"The equivalent amount in USD of the tokens involved in the transaction."},"average_price":{"type":"number","description":"The average price of the tokens involved in the transaction."},"base_token_address":{"type":"string","description":"The address of the base token involved in the transaction."},"base_token_amount":{"type":"number","description":"The amount of base tokens involved in the transaction."},"base_token_symbol":{"type":"string","description":"The symbol of the base token involved in the transaction."},"dex":{"type":"string","description":"The decentralized exchange where the Perpetual transaction occurred."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"liquidation":{"type":"boolean","description":"Indicates whether the transaction was a liquidation."},"liquidation_price":{"type":"number","description":"The price at which the liquidation occurred."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"trade_direction":{"type":"string","description":"The direction of the trade in the Perpetual transaction."},"perp_details":{"type":"string","description":"Additional details about the Perpetual transaction."},"token0_address":{"type":"string","description":"The address of the first token in the LP pair."},"token0_amount":{"type":"number","description":"The amount of the first token in the LP pair."},"token0_amount_usd":{"type":"number","description":"The equivalent amount in USD of the first token in the LP pair."},"token0_name":{"type":"string","description":"The name of the first token in the LP pair."},"token0_price_usd":{"type":"number","description":"The price of the first token in the LP pair in USD."},"token0_symbol":{"type":"string","description":"The symbol of the first token in the LP pair."},"token0_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"token1_address":{"type":"string","description":"The address of the second token in the LP pair."},"token1_amount":{"type":"number","description":"The amount of the second token in the LP pair."},"token1_amount_usd":{"type":"number","description":"The equivalent amount in USD of the second token in the LP pair."},"token1_name":{"type":"string","description":"The name of the second token in the LP pair."},"token1_price_usd":{"type":"number","description":"The price of the second token in the LP pair in USD."},"token1_symbol":{"type":"string","description":"The symbol of the second token in the LP pair."},"token1_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"realized_pnl":{"type":"number","description":"The realized profit and loss of the Perpetual transaction."},"is_nft_perp":{"type":"boolean","description":"Indicates whether the Perpetual transaction involves an NFT."},"position_size":{"type":"number","description":"The size of the position in the Perpetual transaction."},"position_size_usd":{"type":"number","description":"The equivalent amount in USD of the position size."},"leverage":{"type":"number","description":"The leverage used in the Perpetual transaction."},"unrealized_pnl":{"type":"number","description":"The unrealized profit and loss of the Perpetual transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","action","amount_usd","average_price","base_token_address","base_token_amount","base_token_symbol","dex","from","liquidation","liquidation_price","to","trade_direction","perp_details","token0_address","token0_amount","token0_amount_usd","token0_name","token0_price_usd","token0_symbol","token0_icon_link","token1_address","token1_amount","token1_amount_usd","token1_name","token1_price_usd","token1_symbol","token1_icon_link","realized_pnl","is_nft_perp"]},"Flashloan":{"type":"object","description":"This object provides a structure for representing a flashloan event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"address":{"type":"string","description":"The address of the token involved in the transaction."},"amount":{"type":"number","description":"The amount of tokens involved in the transaction."},"amount_usd":{"type":"number","description":"The equivalent amount in USD of the tokens involved in the transaction."},"dex":{"type":"string","description":"The decentralized exchange (DEX) where the flashloan transaction took place."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"health_factor":{"type":"number","description":"The health factor of the wallet after the flashloan transaction."},"name":{"type":"string","description":"The name of the token involved in the transaction."},"platform":{"type":"string","description":"The platform where the flashloan transaction took place."},"price_usd":{"type":"number","description":"The price of the token in USD."},"symbol":{"type":"string","description":"The symbol of the token involved in the transaction."},"token_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","address","amount","amount_usd","dex","from","health_factor","name","platform","price_usd","symbol","token_icon_link"]},"ContractCreation":{"type":"object","description":"This object provides a structure for representing a contract creation event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"amount_usd":{"type":"number","description":"The equivalent amount in USD of the wrapped tokens."},"contract_address":{"type":"string","description":"The address of the smart contract involved in the interaction."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"from_label":{"type":"string","description":"A human-readable label or name associated with the originating wallet."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","amount_usd","contract_address","from","from_label"]},"NftLiquidation":{"type":"object","description":"This object provides a structure for representing a NFT liquidation event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"contract_address":{"type":"string","description":"The address of the NFT contract involved in the interaction."},"currency_address":{"type":"string","description":"The address of the currency involved in the transaction."},"currency_symbol":{"type":"string","description":"The symbol of the currency involved in the transaction."},"dex":{"type":"string","description":"The decentralized exchange where the wrap transaction occurred."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"nft_address":{"type":"string","description":"The address of the NFT contract involved in the interaction."},"nft_name":{"type":"string","description":"The name of the NFT in the transaction."},"nft_symbol":{"type":"string","description":"The symbol of the NFT in the transaction."},"platform":{"type":"string","description":"The platform where the flashloan transaction took place."},"price":{"type":"number","description":"The price of the NFT in the transaction."},"price_usd":{"type":"number","description":"The price of the NFT in USD."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"token_id":{"type":"string","description":"The unique identifier of the NFT in the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","contract_address","currency_address","currency_symbol","dex","from","nft_address","nft_name","nft_symbol","platform","price","price_usd","to","token_id"]},"Option":{"type":"object","description":"This object provides a structure for representing an option event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"action":{"type":"string","description":"The action taken in the option event."},"amount":{"type":"number","description":"The amount of tokens involved in the transaction."},"asset":{"type":"string","description":"The asset involved in the option event."},"dex":{"type":"string","description":"The decentralized exchange (DEX) where the option event took place."},"direction":{"type":"string","description":"The direction of the option event."},"expiry":{"type":"string","description":"The expiry date of the option."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"option_price_usd":{"type":"number","description":"The price of the option in USD."},"position_status":{"type":"string","description":"The status of the option position."},"spot_price_usd":{"type":"number","description":"The spot price of the asset in USD."},"status":{"type":"string","description":"The status of the option event."},"strike_price_usd":{"type":"number","description":"The strike price of the option in USD."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"type":{"type":"string","description":"The type of option event."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","action","amount","asset","dex","direction","expiry","from","option_price_usd","position_status","spot_price_usd","status","strike_price_usd","to","type"]},"NftSweep":{"type":"object","description":"This object provides a structure for representing a NFT sweep event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address involved in the NFT trading transaction."},"wallet_label":{"type":"string","description":"A readable label for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the NFT trading transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, NFT trading."},"chain":{"type":"string","description":"The blockchain network where the trading transaction occurred."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"thumbnail":{"type":"string","description":"A thumbnail image URL of the NFT involved in the transaction."},"image":{"type":"string","description":"A full image URL of the NFT."},"action":{"type":"string","description":"Describes the action taken in the NFT trade, such as 'buy' or 'sell'."},"contract":{"type":"string","description":"The blockchain contract address associated with the NFT."},"marketplace":{"type":"string","description":"The marketplace where the NFT trade occurred, such as OpenSea."},"nft_address":{"type":"string","description":"The blockchain address of the NFT involved in the trade."},"nft_name":{"type":"string","description":"The name of the NFT traded."},"nft_symbol":{"type":"string","description":"The symbol associated with the NFT."},"nft_token_id":{"type":"string","description":"The unique token ID of the NFT involved in the trade."},"price":{"type":"number","format":"double","description":"The price at which the NFT was traded."},"price_usd":{"type":"number","format":"double","description":"The equivalent USD value of the NFT trade."},"profit":{"type":"number","format":"double","description":"The profit earned from the trade. This may be zero in some transactions."},"currency_symbol":{"type":"string","description":"The symbol of the currency used in the trade, such as WETH or ETH."},"buyer":{"type":"string","description":"The wallet address of the buyer in the trade."},"seller":{"type":"string","description":"The wallet address of the seller in the trade."},"token":{"type":"string","description":"The token type used in the transaction."},"first_interaction":{"type":"boolean","description":"Indicates whether this was the first interaction between the buyer and seller."},"bid_accepted":{"type":"boolean","description":"Specifies if the transaction involved a bid being accepted."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","thumbnail","image","action","contract","marketplace","nft_address","nft_name","nft_symbol","nft_token_id","price","price_usd","profit","currency_symbol","buyer","seller","token","first_interaction","bid_accepted"]}}}}
```

## The WebsocketErrorEvent object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"WebsocketErrorEvent":{"type":"object","properties":{"type":{"type":"string","enum":["error"]},"data":{"type":"string","description":"The error message."}},"required":["type","data"]}}}}
```

## The Bridge object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"Bridge":{"type":"object","description":"This object represents a detailed structure for a blockchain transaction, encompassing various aspects like wallet addresses, transaction hash, type, associated chains, and financial details. It is designed to provide a comprehensive view of a transaction, including the wallets involved, the transaction's nature, the chains it spans, and the financial details like the amount and its equivalent in USD. This structure is ideal for applications that require detailed tracking and analysis of blockchain transactions.\n","properties":{"wallet":{"type":"string","description":"The wallet address involved in the transaction."},"wallet_label":{"type":"string","description":"A shortened, more readable version of the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the transaction."},"tx_type":{"type":"string","description":"The type of transaction."},"chain":{"type":"string","description":"The blockchain on which the transaction occurred, like 'ethereum'."},"index":{"type":"integer","description":"A numeric index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp when the transaction occurred."},"block":{"type":"integer","description":"The block number on the blockchain in which the transaction is included."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"from_label":{"type":"string","description":"A shortened, more readable version of the originating wallet address."},"to_label":{"type":"string","description":"A shortened, more readable version of the destination wallet address."},"token_address":{"type":"string","description":"The address of the token involved in the transaction."},"token_name":{"type":"string","description":"The name of the token involved in the transaction."},"token_symbol":{"type":"string","description":"The symbol of the token involved in the transaction."},"token_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"amount":{"type":"number","format":"double","description":"The amount of the token involved in the transaction."},"amount_usd":{"type":"number","format":"double","description":"The equivalent amount in USD of the tokens involved in the transaction."},"from_chain":{"type":"string","description":"The originating chain of the transaction, in cases of cross-chain activities."},"to_chain":{"type":"string","description":"The destination chain of the transaction, in cases of cross-chain activities."},"platform":{"type":"string","description":"The platform or service used for the transaction."},"price":{"type":"number","format":"double","description":"The price of the token at the time of the transaction."},"type":{"type":"string","description":"Specifies the nature of the transaction, like 'withdraw', 'deposit', etc."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","from_label","to_label","token_address","token_name","token_symbol","amount","amount_usd","from_chain","to_chain","platform","price","type","token_icon_link"]}}}}
```

## The Lending object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"Lending":{"type":"object","description":"This object represents the data structure for a specific transaction related to decentralized finance (DeFi) activities such as lending, borrowing, and other related actions. It provides detailed information about the transaction, including wallet addresses, transaction hash, type of transaction, chain details, and financial figures. This structure is particularly useful for platforms tracking DeFi activities, offering insights into the specifics of each transaction, such as the asset involved, the amount, the health factor in lending platforms, and the price of the asset in USD at the time of the transaction.\n","properties":{"wallet":{"type":"string","description":"The wallet address associated with the transaction."},"wallet_label":{"type":"string","description":"A more readable, shortened version of the wallet address."},"tx_hash":{"type":"string","description":"The unique identifier of the transaction, represented as a hash."},"tx_type":{"type":"string","description":"Specifies the type of DeFi transaction, such as lending, borrowing, etc."},"chain":{"type":"string","description":"Indicates the blockchain network on which the transaction occurred."},"index":{"type":"integer","description":"A sequential index or identifier for the transaction within a particular dataset or list."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number in the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"from_label":{"type":"string","description":"A readable, abbreviated form of the 'from' wallet address."},"action":{"type":"string","description":"Describes the action taken in the transaction, such as 'Repaid' in a lending scenario."},"address":{"type":"string","description":"The smart contract address involved in the transaction."},"amount":{"type":"number","format":"double","description":"The amount of the asset involved in the transaction."},"amount_usd":{"type":"number","format":"double","description":"The equivalent value of the transaction amount in USD."},"dex":{"type":"string","description":"The decentralized exchange or platform where the transaction occurred, such as AaveV2."},"health_factor":{"type":"number","format":"double","description":"A metric specific to lending platforms, indicating the health of the loan or position."},"name":{"type":"string","description":"The name of the asset involved in the transaction."},"platform":{"type":"string","description":"The DeFi platform associated with the transaction, like AaveV3."},"price_usd":{"type":"number","format":"double","description":"The price of the asset in USD at the time of the transaction."},"symbol":{"type":"string","description":"The symbol of the asset involved in the transaction."},"token_icon_link":{"type":"string","description":"A URL link to the icon image of the token involved in the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","from_label","action","address","amount","amount_usd","dex","health_factor","name","platform","price_usd","symbol","token_icon_link"]}}}}
```

## The LP object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"LP":{"type":"object","description":"This object provides a comprehensive overview of a liquidity pool (LP) transaction on a decentralized exchange (DEX). It includes details about the wallet involved, the transaction hash, type, and associated blockchain, as well as specific information about the assets involved in the transaction. This structure is particularly useful for platforms that track and analyze liquidity pool actions, such as adding or removing liquidity, offering insights into the specifics of each action, including the assets involved, their amounts in both the native token and USD value, and their respective prices in USD.\n","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"dex":{"type":"string","description":"The name of the decentralized exchange where the LP transaction occurred."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"type":{"type":"string","description":"Specifies the nature of the LP transaction, such as 'add' or 'remove'."},"token0_address":{"type":"string","description":"The address of the first token involved in the LP transaction."},"token0_amount":{"type":"number","format":"double","description":"The amount of the first token involved in the transaction."},"token0_amount_usd":{"type":"number","format":"double","description":"The USD value of the first token amount at the time of the transaction."},"token0_name":{"type":"string","description":"The name of the first token involved in the transaction."},"token0_price_usd":{"type":"number","format":"double","description":"The price of the first token in USD."},"token0_symbol":{"type":"string","description":"The symbol of the first token involved in the transaction."},"token0_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"token1_address":{"type":"string","description":"The address of the second token involved in the LP transaction."},"token1_amount":{"type":"number","format":"double","description":"The amount of the second token involved in the transaction."},"token1_amount_usd":{"type":"number","format":"double","description":"The USD value of the second token amount at the time of the transaction."},"token1_name":{"type":"string","description":"The name of the second token involved in the transaction."},"token1_price_usd":{"type":"number","format":"double","description":"The price of the second token in USD."},"token1_symbol":{"type":"string","description":"The symbol of the second token involved in the transaction."},"token1_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"lower_bound":{"type":"number","format":"double","description":"Indicates the lower bound of the price range for the LP position, relevant in certain types of liquidity pools."},"upper_bound":{"type":"number","format":"double","description":"Indicates the upper bound of the price range for the LP position, relevant in certain types of liquidity pools."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","dex","from","type","token0_address","token0_amount","token0_amount_usd","token0_name","token0_price_usd","token0_symbol","token0_icon_link","token1_address","token1_amount","token1_amount_usd","token1_name","token1_price_usd","token1_symbol","token1_icon_link","lower_bound","upper_bound"]}}}}
```

## The NftLending object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"NftLending":{"type":"object","description":"This object encapsulates detailed information about a Non-Fungible Token (NFT) lending transaction. It includes comprehensive details such as wallet addresses, transaction hash, the type of NFT transaction, the blockchain used, and timestamps. Additionally, it provides specifics about the NFT involved, including its address, name, symbol, image, and the terms of the lending agreement. This structure is particularly useful for platforms that need to track and manage NFT lending activities, providing all necessary details for analyzing and processing such transactions.\n","properties":{"wallet":{"type":"string","description":"The wallet address involved in the NFT lending transaction."},"wallet_label":{"type":"string","description":"A more readable label or identifier for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the NFT lending transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, NFT lending."},"chain":{"type":"string","description":"The blockchain network on which the transaction was conducted."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"from_label":{"type":"string","description":"A readable version of the 'from' wallet address."},"to_label":{"type":"string","description":"A readable version of the 'to' wallet address."},"thumbnail":{"type":"string","description":"A thumbnail image URL of the NFT involved in the transaction."},"image":{"type":"string","description":"A full image URL of the NFT."},"action":{"type":"string","description":"Describes the action taken in the NFT lending transaction, such as 'buy', 'lend', etc."},"currency_address":{"type":"string","description":"The blockchain address of the currency used in the transaction."},"currency_symbol":{"type":"string","description":"The symbol of the currency used in the transaction."},"interest":{"type":"number","format":"double","description":"The interest rate applied in the NFT lending transaction."},"nft_address":{"type":"string","description":"The blockchain address of the NFT involved in the transaction."},"nft_name":{"type":"string","description":"The name of the NFT."},"nft_symbol":{"type":"string","description":"The symbol of the NFT."},"platform":{"type":"string","description":"The platform or service through which the NFT lending transaction was conducted."},"nft_token_id":{"type":"string","description":"The unique identifier for the specific NFT within its collection."},"price":{"type":"number","format":"double","description":"The price at which the NFT was lent or transacted."},"price_usd":{"type":"number","format":"double","description":"The equivalent USD value of the transaction price."},"terms":{"type":"number","format":"double","description":"Specifies the terms of the NFT lending agreement."},"refinance":{"type":"boolean","description":"Indicates whether the transaction involved refinancing of the NFT."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","from_label","to_label","thumbnail","image","action","currency_address","currency_symbol","interest","nft_address","nft_name","nft_symbol","platform","nft_token_id","price","price_usd","terms","refinance"]}}}}
```

## The NftMint object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"NftMint":{"type":"object","description":"This object represents the data structure for a Non-Fungible Token (NFT) minting transaction. It provides detailed information about the transaction, including wallet addresses, transaction hash, the type of NFT transaction (in this case, minting), and blockchain specifics. Additionally, it includes detailed information about the NFT minted, such as its image, contract address, token ID, and associated fees. This structure is particularly useful for platforms tracking NFT minting activities, offering insights into the creation of new NFTs, their associated costs, and the blockchain details.\n","properties":{"wallet":{"type":"string","description":"The wallet address involved in the NFT minting transaction."},"wallet_label":{"type":"string","description":"A more readable label or identifier for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the NFT minting transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, NFT minting."},"chain":{"type":"string","description":"The blockchain network on which the minting transaction was conducted."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"from_label":{"type":"string","description":"A readable version of the 'from' wallet address."},"to_label":{"type":"string","description":"A readable version of the 'to' wallet address."},"thumbnail":{"type":"string","description":"A thumbnail image URL of the NFT involved in the transaction."},"image":{"type":"string","description":"A full image URL of the NFT."},"amount":{"type":"number","format":"double","description":"The number of items of the NFT minted in the transaction."},"contract_address":{"type":"string","description":"The blockchain address of the contract under which the NFT is minted."},"contract_type":{"type":"string","description":"The type of contract used for the NFT, such as ERC721."},"fee":{"type":"number","format":"double","description":"The transaction fee incurred for minting the NFT."},"nft_name":{"type":"string","description":"The name of the NFT minted."},"nft_symbol":{"type":"string","description":"The symbol associated with the NFT."},"nft_token_id":{"type":"string","description":"The unique token ID of the minted NFT."},"currency_symbol":{"type":"string","description":"The symbol of the currency used in the transaction (e.g., ETH, MATIC)."},"type":{"type":"string","description":"Indicates the contract standard of the NFT, such as ERC721."},"value":{"type":"number","format":"double","description":"The value of the transaction. For minting, this is often zero since the NFT is being created."},"value_usd":{"type":"number","format":"double","description":"The equivalent USD value of the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","from_label","to_label","thumbnail","image","amount","contract_address","contract_type","fee","nft_name","nft_symbol","nft_token_id","currency_symbol","type","value","value_usd"]}}}}
```

## The NftTrade object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"NftTrade":{"type":"object","description":"This object encapsulates the details of a Non-Fungible Token (NFT) trading transaction. It includes comprehensive information such as wallet addresses, transaction hash, type of transaction (NFT trade), blockchain details, and timestamps. The structure provides specific data about the NFT trade, including the NFT's image, contract address, marketplace of the trade, and price details in both cryptocurrency and USD. Additionally, it includes information about the buyer, seller, and whether the transaction involved a bid being accepted. This structure is ideal for platforms that monitor and analyze NFT trading activities, offering detailed insights into each trade, its valuation, and the parties involved.\n","properties":{"wallet":{"type":"string","description":"The wallet address involved in the NFT trading transaction."},"wallet_label":{"type":"string","description":"A readable label for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the NFT trading transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, NFT trading."},"chain":{"type":"string","description":"The blockchain network where the trading transaction occurred."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"thumbnail":{"type":"string","description":"A thumbnail image URL of the NFT involved in the transaction."},"image":{"type":"string","description":"A full image URL of the NFT."},"action":{"type":"string","description":"Describes the action taken in the NFT trade, such as 'buy' or 'sell'."},"contract":{"type":"string","description":"The blockchain contract address associated with the NFT."},"marketplace":{"type":"string","description":"The marketplace where the NFT trade occurred, such as OpenSea."},"nft_address":{"type":"string","description":"The blockchain address of the NFT involved in the trade."},"nft_name":{"type":"string","description":"The name of the NFT traded."},"nft_symbol":{"type":"string","description":"The symbol associated with the NFT."},"nft_token_id":{"type":"string","description":"The unique token ID of the NFT involved in the trade."},"price":{"type":"number","format":"double","description":"The price at which the NFT was traded."},"price_usd":{"type":"number","format":"double","description":"The equivalent USD value of the NFT trade."},"profit":{"type":"number","format":"double","description":"The profit earned from the trade. This may be zero in some transactions."},"currency_symbol":{"type":"string","description":"The symbol of the currency used in the trade, such as WETH or ETH."},"buyer":{"type":"string","description":"The wallet address of the buyer in the trade."},"seller":{"type":"string","description":"The wallet address of the seller in the trade."},"token":{"type":"string","description":"The token type used in the transaction."},"first_interaction":{"type":"boolean","description":"Indicates whether this was the first interaction between the buyer and seller."},"bid_accepted":{"type":"boolean","description":"Specifies if the transaction involved a bid being accepted."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","thumbnail","image","action","contract","marketplace","nft_address","nft_name","nft_symbol","nft_token_id","price","price_usd","profit","currency_symbol","buyer","seller","token","first_interaction","bid_accepted"]}}}}
```

## The NftTransfer object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"NftTransfer":{"type":"object","description":"This object type details a Non-Fungible Token (NFT) transfer transaction. It includes essential information such as wallet addresses, transaction hash, NFT details, and blockchain specifics. This structure is particularly useful for tracking NFT transfers, providing a complete overview of the transaction, including the involved parties (from and to addresses), the NFT's contract details, and the transaction's metadata such as timestamps and blockchain network. The object also includes the NFT's image, name, symbol, and token ID, offering a comprehensive view of the NFT being transferred.\n","properties":{"wallet":{"type":"string","description":"The wallet address involved in the NFT transfer transaction."},"wallet_label":{"type":"string","description":"A readable label for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the NFT transfer transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, NFT transfer."},"chain":{"type":"string","description":"The blockchain network where the transfer transaction occurred."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"from_label":{"type":"string","description":"A readable version of the 'from' wallet address."},"to_label":{"type":"string","description":"A readable version of the 'to' wallet address."},"thumbnail":{"type":"string","description":"A thumbnail image URL of the NFT involved in the transaction."},"image":{"type":"string","description":"A full image URL of the NFT."},"contract_address":{"type":"string","description":"The blockchain address of the contract under which the NFT is registered."},"contract_type":{"type":"string","description":"The type of contract used for the NFT, such as ERC721."},"fee":{"type":"number","format":"double","description":"The transaction fee incurred for the transfer of the NFT."},"nft_name":{"type":"string","description":"The name of the NFT being transferred."},"nft_symbol":{"type":"string","description":"The symbol associated with the NFT."},"nft_token_id":{"type":"string","description":"The unique token ID of the NFT involved in the transfer."},"type":{"type":"string","description":"Indicates the contract standard of the NFT, such as ERC721."},"value":{"type":"number","format":"double","description":"The value of the NFT at the time of the transfer. This might be represented in the native cryptocurrency of the blockchain."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","from_label","to_label","thumbnail","image","contract_address","contract_type","fee","nft_name","nft_symbol","nft_token_id","type","value"]}}}}
```

## The Swap object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"Swap":{"type":"object","description":"This object type provides detailed information about a cryptocurrency swap transaction. It includes critical details such as wallet addresses, transaction hash, type of swap, blockchain specifics, and timestamps. The structure outlines the specifics of the assets involved in the swap, including their addresses, names, symbols, amounts, and USD values. It is particularly useful for platforms tracking and analyzing DeFi swap transactions, offering insights into the trade's details, such as the decentralized exchange (DEX) used, the tokens exchanged, and their respective values. This comprehensive structure is ideal for users or systems needing a detailed view of swap transactions on blockchain networks.\n","properties":{"wallet":{"type":"string","description":"The wallet address that initiated the swap transaction."},"wallet_label":{"type":"string","description":"A readable label for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the swap transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, a token swap."},"chain":{"type":"string","description":"The blockchain network where the swap transaction occurred."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"dex":{"type":"string","description":"The decentralized exchange where the swap transaction took place."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction (often the same as the 'from' address in swap transactions)."},"token0_address":{"type":"string","description":"The address of the first token involved in the swap."},"token0_amount":{"type":"number","format":"double","description":"The amount of the first token involved in the swap."},"token0_amount_usd":{"type":"number","format":"double","description":"The USD value of the first token amount at the time of the swap."},"token0_name":{"type":"string","description":"The name of the first token involved in the swap."},"token0_price_usd":{"type":"number","format":"double","description":"The price of the first token in USD."},"token0_symbol":{"type":"string","description":"The symbol of the first token involved in the swap."},"token0_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"token1_address":{"type":"string","description":"The address of the second token involved in the swap."},"token1_amount":{"type":"number","format":"double","description":"The amount of the second token involved in the swap."},"token1_amount_usd":{"type":"number","format":"double","description":"The USD value of the second token amount at the time of the swap."},"token1_name":{"type":"string","description":"The name of the second token involved in the swap."},"token1_price_usd":{"type":"number","format":"double","description":"The price of the second token in USD."},"token1_symbol":{"type":"string","description":"The symbol of the second token involved in the swap."},"token1_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"first_interaction":{"type":"boolean","description":"Indicates whether this transaction was the first interaction between the involved wallet addresses."},"token_market_cap":{"type":"object","description":"Contains the market capitalization and liquidity details of the tokens involved in the swap transaction.","properties":{"token_address":{"type":"string","description":"The address of the token."},"market_cap":{"type":"number","format":"double","description":"The market capitalization of the token."},"liquidity":{"type":"number","format":"double","description":"The liquidity of the token."}},"required":["token_address","market_cap","liquidity"]},"is_sell":{"type":"boolean","description":"Indicates whether the swap transaction was a sell order."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","dex","from","to","token0_address","token0_amount","token0_amount_usd","token0_name","token0_price_usd","token0_symbol","token0_icon_link","token1_address","token1_amount","token1_amount_usd","token1_name","token1_price_usd","token1_symbol","token1_icon_link","first_interaction","is_sell"]}}}}
```

## The Transfer object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"Transfer":{"type":"object","description":"This object represents the details of a cryptocurrency transfer transaction. It includes essential information such as wallet addresses, transaction hash, type of transfer, blockchain details, and timestamps. The structure is particularly useful for tracking standard token transfers on blockchain networks, providing a comprehensive overview of the transaction, including the amount transferred in USD, the token's contract address, its name, and symbol. This detailed structure is ideal for users or systems requiring a thorough view of token transfer transactions, including the specifics of the token involved and the value of the transaction.\n","properties":{"wallet":{"type":"string","description":"The wallet address involved in the transfer transaction."},"wallet_label":{"type":"string","description":"A readable label for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the transfer transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, a token transfer."},"chain":{"type":"string","description":"The blockchain network where the transfer transaction occurred."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"from_label":{"type":"string","description":"A readable version of the 'from' wallet address."},"to_label":{"type":"string","description":"A readable version of the 'to' wallet address."},"amount_usd":{"type":"number","format":"double","description":"The USD value of the amount transferred in the transaction."},"contract_address":{"type":"string","description":"The blockchain address of the contract under which the token is registered."},"name":{"type":"string","description":"The name of the token being transferred."},"symbol":{"type":"string","description":"The symbol of the token being transferred."},"token_price_usd":{"type":"number","format":"double","description":"The price of the token in USD at the time of the transaction."},"type":{"type":"string","description":"Indicates the contract standard of the token, such as ERC20."},"token_icon_link":{"type":"string","description":"A URL link to the token's icon image."},"token_market_cap":{"type":"object","description":"Contains the market capitalization and liquidity details of the tokens involved in the swap transaction.","properties":{"token_address":{"type":"string","description":"The address of the token."},"market_cap":{"type":"number","format":"double","description":"The market capitalization of the token."},"liquidity":{"type":"number","format":"double","description":"The liquidity of the token."}},"required":["token_address","market_cap","liquidity"]},"mempool":{"type":"boolean","description":"For Bitcoin transactions, this field indicates whether the transaction is in the mempool."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","from_label","to_label","amount_usd","contract_address","name","symbol","token_price_usd","type","token_icon_link"]}}}}
```

## The ContractInteraction object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"ContractInteraction":{"type":"object","description":"This object provides a structure for representing a contract interaction event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"contract_address":{"type":"string","description":"The address of the smart contract involved in the interaction."},"contract_label":{"type":"string","description":"A human-readable label or name associated with the smart contract."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","contract_address","contract_label"]}}}}
```

## The Wrap object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"Wrap":{"type":"object","description":"This object provides a structure for representing a wrap event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"dex":{"type":"string","description":"The decentralized exchange where the wrap transaction occurred."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"action":{"type":"string"},"amount":{"type":"number","description":"The amount of tokens wrapped in the transaction."},"amount_usd":{"type":"number","description":"The equivalent amount in USD of the wrapped tokens."},"contract_address":{"type":"string","description":"The address of the smart contract involved in the interaction."},"name":{"type":"string","description":"The name of the token wrapped in the transaction."},"symbol":{"type":"string","description":"The symbol of the token wrapped in the transaction."},"token_price_usd":{"type":"number","description":"The price of the token in USD at the time of the transaction."},"token_type":{"type":"string","description":"The type of token wrapped in the transaction."},"token_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","dex","from","to","action","amount","amount_usd","contract_address","name","symbol","token_price_usd","token_type","token_icon_link"]}}}}
```

## The SudoPool object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"SudoPool":{"type":"object","description":"This object provides a structure for representing a Sudo Pool event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"dex":{"type":"string","description":"The decentralized exchange where the wrap transaction occurred."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"nft_address":{"type":"string","description":"The address of the NFT contract involved in the interaction."},"nft_amount":{"type":"integer","description":"The amount of NFTs involved in the transaction."},"nft_price":{"type":"number","description":"The price of the NFT in the transaction."},"nft_symbol":{"type":"string","description":"The symbol of the NFT in the transaction."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"token0_address":{"type":"string","description":"The address of the first token in the LP pair."},"token0_amount":{"type":"number","description":"The amount of the first token in the LP pair."},"token0_amount_usd":{"type":"number","description":"The equivalent amount in USD of the first token in the LP pair."},"token0_name":{"type":"string","description":"The name of the first token in the LP pair."},"token0_price_usd":{"type":"number","description":"The price of the first token in the LP pair in USD."},"token0_symbol":{"type":"string","description":"The symbol of the first token in the LP pair."},"token0_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","nft_address","nft_amount","nft_price","nft_symbol","token0_address","token0_amount","token0_amount_usd","token0_name","token0_price_usd","token0_symbol","from","to","token0_icon_link"]}}}}
```

## The Reward object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"Reward":{"type":"object","description":"This object provides a structure for representing a reward event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"address":{"type":"string","description":"The address of the token involved in the transaction."},"amount":{"type":"number","description":"The amount of tokens involved in the transaction."},"amount_usd":{"type":"number","description":"The equivalent amount in USD of the tokens involved in the transaction."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"name":{"type":"string","description":"The name of the token involved in the transaction."},"price_usd":{"type":"number","description":"The price of the token in USD."},"symbol":{"type":"string","description":"The symbol of the token involved in the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","address","amount","amount_usd","from","name","price_usd","symbol"]}}}}
```

## The Staking object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"Staking":{"type":"object","description":"This object provides a structure for representing a staking event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"from_label":{"type":"string","description":"A human-readable label or name associated with the originating wallet."},"to_label":{"type":"string","description":"A human-readable label or name associated with the destination wallet."},"amount":{"type":"number","description":"The amount of tokens staked in the transaction."},"amount_usd":{"type":"number","description":"The equivalent amount in USD of the staked tokens."},"token_price_usd":{"type":"number","description":"The price of the token in USD."},"contract_address":{"type":"string","description":"The address of the smart contract involved in the interaction."},"symbol":{"type":"string","description":"The symbol of the token staked in the transaction."},"name":{"type":"string","description":"The name of the token staked in the transaction."},"action":{"type":"string","description":"The action taken in the staking transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","from_label","to_label","amount","amount_usd","token_price_usd","contract_address","symbol","name","action"]}}}}
```

## The Perp object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"Perp":{"type":"object","description":"This object provides a structure for representing a Perpetual event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"action":{"type":"string","description":"The action taken in the Perpetual event."},"amount_usd":{"type":"number","description":"The equivalent amount in USD of the tokens involved in the transaction."},"average_price":{"type":"number","description":"The average price of the tokens involved in the transaction."},"base_token_address":{"type":"string","description":"The address of the base token involved in the transaction."},"base_token_amount":{"type":"number","description":"The amount of base tokens involved in the transaction."},"base_token_symbol":{"type":"string","description":"The symbol of the base token involved in the transaction."},"dex":{"type":"string","description":"The decentralized exchange where the Perpetual transaction occurred."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"liquidation":{"type":"boolean","description":"Indicates whether the transaction was a liquidation."},"liquidation_price":{"type":"number","description":"The price at which the liquidation occurred."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"trade_direction":{"type":"string","description":"The direction of the trade in the Perpetual transaction."},"perp_details":{"type":"string","description":"Additional details about the Perpetual transaction."},"token0_address":{"type":"string","description":"The address of the first token in the LP pair."},"token0_amount":{"type":"number","description":"The amount of the first token in the LP pair."},"token0_amount_usd":{"type":"number","description":"The equivalent amount in USD of the first token in the LP pair."},"token0_name":{"type":"string","description":"The name of the first token in the LP pair."},"token0_price_usd":{"type":"number","description":"The price of the first token in the LP pair in USD."},"token0_symbol":{"type":"string","description":"The symbol of the first token in the LP pair."},"token0_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"token1_address":{"type":"string","description":"The address of the second token in the LP pair."},"token1_amount":{"type":"number","description":"The amount of the second token in the LP pair."},"token1_amount_usd":{"type":"number","description":"The equivalent amount in USD of the second token in the LP pair."},"token1_name":{"type":"string","description":"The name of the second token in the LP pair."},"token1_price_usd":{"type":"number","description":"The price of the second token in the LP pair in USD."},"token1_symbol":{"type":"string","description":"The symbol of the second token in the LP pair."},"token1_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."},"realized_pnl":{"type":"number","description":"The realized profit and loss of the Perpetual transaction."},"is_nft_perp":{"type":"boolean","description":"Indicates whether the Perpetual transaction involves an NFT."},"position_size":{"type":"number","description":"The size of the position in the Perpetual transaction."},"position_size_usd":{"type":"number","description":"The equivalent amount in USD of the position size."},"leverage":{"type":"number","description":"The leverage used in the Perpetual transaction."},"unrealized_pnl":{"type":"number","description":"The unrealized profit and loss of the Perpetual transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","action","amount_usd","average_price","base_token_address","base_token_amount","base_token_symbol","dex","from","liquidation","liquidation_price","to","trade_direction","perp_details","token0_address","token0_amount","token0_amount_usd","token0_name","token0_price_usd","token0_symbol","token0_icon_link","token1_address","token1_amount","token1_amount_usd","token1_name","token1_price_usd","token1_symbol","token1_icon_link","realized_pnl","is_nft_perp"]}}}}
```

## The Flashloan object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"Flashloan":{"type":"object","description":"This object provides a structure for representing a flashloan event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"address":{"type":"string","description":"The address of the token involved in the transaction."},"amount":{"type":"number","description":"The amount of tokens involved in the transaction."},"amount_usd":{"type":"number","description":"The equivalent amount in USD of the tokens involved in the transaction."},"dex":{"type":"string","description":"The decentralized exchange (DEX) where the flashloan transaction took place."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"health_factor":{"type":"number","description":"The health factor of the wallet after the flashloan transaction."},"name":{"type":"string","description":"The name of the token involved in the transaction."},"platform":{"type":"string","description":"The platform where the flashloan transaction took place."},"price_usd":{"type":"number","description":"The price of the token in USD."},"symbol":{"type":"string","description":"The symbol of the token involved in the transaction."},"token_icon_link":{"type":"string","description":"A link to the icon of the token involved in the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","address","amount","amount_usd","dex","from","health_factor","name","platform","price_usd","symbol","token_icon_link"]}}}}
```

## The ContractCreation object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"ContractCreation":{"type":"object","description":"This object provides a structure for representing a contract creation event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"amount_usd":{"type":"number","description":"The equivalent amount in USD of the wrapped tokens."},"contract_address":{"type":"string","description":"The address of the smart contract involved in the interaction."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"from_label":{"type":"string","description":"A human-readable label or name associated with the originating wallet."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","amount_usd","contract_address","from","from_label"]}}}}
```

## The NftLiquidation object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"NftLiquidation":{"type":"object","description":"This object provides a structure for representing a NFT liquidation event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"contract_address":{"type":"string","description":"The address of the NFT contract involved in the interaction."},"currency_address":{"type":"string","description":"The address of the currency involved in the transaction."},"currency_symbol":{"type":"string","description":"The symbol of the currency involved in the transaction."},"dex":{"type":"string","description":"The decentralized exchange where the wrap transaction occurred."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"nft_address":{"type":"string","description":"The address of the NFT contract involved in the interaction."},"nft_name":{"type":"string","description":"The name of the NFT in the transaction."},"nft_symbol":{"type":"string","description":"The symbol of the NFT in the transaction."},"platform":{"type":"string","description":"The platform where the flashloan transaction took place."},"price":{"type":"number","description":"The price of the NFT in the transaction."},"price_usd":{"type":"number","description":"The price of the NFT in USD."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"token_id":{"type":"string","description":"The unique identifier of the NFT in the transaction."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","contract_address","currency_address","currency_symbol","dex","from","nft_address","nft_name","nft_symbol","platform","price","price_usd","to","token_id"]}}}}
```

## The Option object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"Option":{"type":"object","description":"This object provides a structure for representing an option event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address participating in the LP transaction."},"wallet_label":{"type":"string","description":"A human-readable label or name associated with the wallet, such as a ENS name."},"tx_hash":{"type":"string","description":"The unique transaction hash identifying this specific LP transaction."},"tx_type":{"type":"string","description":"Indicates the type of transaction, in this case, liquidity pool (LP) related."},"chain":{"type":"string","description":"The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"action":{"type":"string","description":"The action taken in the option event."},"amount":{"type":"number","description":"The amount of tokens involved in the transaction."},"asset":{"type":"string","description":"The asset involved in the option event."},"dex":{"type":"string","description":"The decentralized exchange (DEX) where the option event took place."},"direction":{"type":"string","description":"The direction of the option event."},"expiry":{"type":"string","description":"The expiry date of the option."},"from":{"type":"string","description":"The originating wallet address for the transaction."},"option_price_usd":{"type":"number","description":"The price of the option in USD."},"position_status":{"type":"string","description":"The status of the option position."},"spot_price_usd":{"type":"number","description":"The spot price of the asset in USD."},"status":{"type":"string","description":"The status of the option event."},"strike_price_usd":{"type":"number","description":"The strike price of the option in USD."},"to":{"type":"string","description":"The destination wallet address for the transaction."},"type":{"type":"string","description":"The type of option event."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","action","amount","asset","dex","direction","expiry","from","option_price_usd","position_status","spot_price_usd","status","strike_price_usd","to","type"]}}}}
```

## The NftSweep object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"NftSweep":{"type":"object","description":"This object provides a structure for representing a NFT sweep event on the blockchain.","properties":{"wallet":{"type":"string","description":"The wallet address involved in the NFT trading transaction."},"wallet_label":{"type":"string","description":"A readable label for the wallet address."},"tx_hash":{"type":"string","description":"The unique hash identifier of the NFT trading transaction."},"tx_type":{"type":"string","description":"Specifies the type of transaction, in this case, NFT trading."},"chain":{"type":"string","description":"The blockchain network where the trading transaction occurred."},"index":{"type":"integer","description":"A numerical index or identifier for the transaction."},"timestamp":{"type":"integer","description":"The timestamp marking when the transaction was executed."},"block":{"type":"integer","description":"The block number on the blockchain where this transaction is recorded."},"from":{"type":"string","description":"The originating wallet address of the transaction."},"to":{"type":"string","description":"The destination wallet address of the transaction."},"thumbnail":{"type":"string","description":"A thumbnail image URL of the NFT involved in the transaction."},"image":{"type":"string","description":"A full image URL of the NFT."},"action":{"type":"string","description":"Describes the action taken in the NFT trade, such as 'buy' or 'sell'."},"contract":{"type":"string","description":"The blockchain contract address associated with the NFT."},"marketplace":{"type":"string","description":"The marketplace where the NFT trade occurred, such as OpenSea."},"nft_address":{"type":"string","description":"The blockchain address of the NFT involved in the trade."},"nft_name":{"type":"string","description":"The name of the NFT traded."},"nft_symbol":{"type":"string","description":"The symbol associated with the NFT."},"nft_token_id":{"type":"string","description":"The unique token ID of the NFT involved in the trade."},"price":{"type":"number","format":"double","description":"The price at which the NFT was traded."},"price_usd":{"type":"number","format":"double","description":"The equivalent USD value of the NFT trade."},"profit":{"type":"number","format":"double","description":"The profit earned from the trade. This may be zero in some transactions."},"currency_symbol":{"type":"string","description":"The symbol of the currency used in the trade, such as WETH or ETH."},"buyer":{"type":"string","description":"The wallet address of the buyer in the trade."},"seller":{"type":"string","description":"The wallet address of the seller in the trade."},"token":{"type":"string","description":"The token type used in the transaction."},"first_interaction":{"type":"boolean","description":"Indicates whether this was the first interaction between the buyer and seller."},"bid_accepted":{"type":"boolean","description":"Specifies if the transaction involved a bid being accepted."}},"required":["wallet","wallet_label","tx_hash","tx_type","chain","index","timestamp","block","from","to","thumbnail","image","action","contract","marketplace","nft_address","nft_name","nft_symbol","nft_token_id","price","price_usd","profit","currency_symbol","buyer","seller","token","first_interaction","bid_accepted"]}}}}
```

## The PortfolioAsset object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"PortfolioAsset":{"type":"object","properties":{"chain":{"type":"string","description":"The chain of the token."},"token_address":{"type":"string","description":"The token address."},"token_name":{"type":"string","description":"The token name."},"token_symbol":{"type":"string","description":"The token symbol."},"platform":{"type":"string","description":"The token launch platform code."},"platform_ui":{"type":"string","description":"The human-readable token launch platform name."},"token_price_usd":{"type":"number","description":"The token price in USD."},"balance":{"type":"number","description":"The token balance."},"total_usd_value":{"type":"number","description":"The total USD value."},"supply":{"type":"number","description":"The token supply."},"supply_owned":{"type":"number","description":"The token supply owned."}},"required":["token_address","token_name","token_symbol","token_price_usd","balance","total_usd_value","supply","supply_owned"]}}}}
```

## The WalletPortfolioResponse object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"WalletPortfolioResponse":{"type":"object","description":"The response schema for the /api/v1/{wallet}/portfolio endpoint.","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the standard response status object, which indicates the success or failure of the API request."},"data":{"type":"object","description":"Contains the main data of the response.","properties":{"last_updated":{"type":"integer","description":"The unix timestamp of the last portfolio update."},"total_usd_value":{"type":"number","description":"The total USD value of the portfolio."},"portfolio":{"type":"array","items":{"$ref":"#/components/schemas/PortfolioAsset"},"description":"Contains the portfolio assets."}},"required":["last_updated"]},"message":{"type":"string","description":"A descriptive message accompanying the response, often used to provide additional information or context about the results or the status of the request."}},"required":["status","data"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]},"PortfolioAsset":{"type":"object","properties":{"chain":{"type":"string","description":"The chain of the token."},"token_address":{"type":"string","description":"The token address."},"token_name":{"type":"string","description":"The token name."},"token_symbol":{"type":"string","description":"The token symbol."},"platform":{"type":"string","description":"The token launch platform code."},"platform_ui":{"type":"string","description":"The human-readable token launch platform name."},"token_price_usd":{"type":"number","description":"The token price in USD."},"balance":{"type":"number","description":"The token balance."},"total_usd_value":{"type":"number","description":"The total USD value."},"supply":{"type":"number","description":"The token supply."},"supply_owned":{"type":"number","description":"The token supply owned."}},"required":["token_address","token_name","token_symbol","token_price_usd","balance","total_usd_value","supply","supply_owned"]}}}}
```

## The WalletTokenPositionsResponse object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"WalletTokenPositionsResponse":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus"},"data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/WalletTokenPosition"}},"paging":{"type":"object","properties":{"next_cursor":{"type":"string","nullable":true,"description":"Cursor for the next page; null on the last page."}}}}}}},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]},"WalletTokenPosition":{"type":"object","properties":{"chain":{"type":"string"},"wallet":{"type":"string"},"token_address":{"type":"string"},"token_symbol":{"type":"string"},"token_name":{"type":"string"},"platform":{"type":"string","description":"The token launch platform code."},"platform_ui":{"type":"string","description":"The human-readable token launch platform name."},"collateral":{"type":"string","description":"The token the position was traded against."},"bought_usd":{"type":"number"},"bought_native":{"type":"number"},"bought_amount":{"type":"number"},"sold_usd":{"type":"number"},"sold_native":{"type":"number"},"sold_amount":{"type":"number"},"sold_fees_usd":{"type":"number"},"sold_fees_native":{"type":"number"},"holding_usd":{"type":"number"},"holding_native":{"type":"number"},"holding_amount":{"type":"number"},"holding_raw":{"type":"string","description":"The holding in the token's smallest unit."},"realized_profit_usd":{"type":"number"},"realized_profit_native":{"type":"number"},"realized_profit_roi":{"type":"number"},"realized_profit_roi_native":{"type":"number"},"unrealized_profit_usd":{"type":"number"},"unrealized_profit_native":{"type":"number"},"unrealized_profit_roi":{"type":"number"},"unrealized_profit_roi_native":{"type":"number"},"total_profit_usd":{"type":"number"},"total_profit_native":{"type":"number"},"total_profit_roi":{"type":"number"},"total_profit_roi_native":{"type":"number"},"current_price_usd":{"type":"number"},"current_price_native":{"type":"number"},"market_cap":{"type":"number"},"avg_buy_price_usd":{"type":"number"},"avg_buy_price_native":{"type":"number"},"avg_sell_price_usd":{"type":"number"},"avg_sell_price_native":{"type":"number"},"avg_buy_market_cap_usd":{"type":"number"},"avg_sell_market_cap_usd":{"type":"number"},"last_trade_timestamp":{"type":"integer","description":"Unix timestamp of the wallet's last trade in this token."},"migrated_at":{"type":"integer","nullable":true,"description":"Unix timestamp of the token's migration off its launchpad, if any."},"has_cost_basis":{"type":"boolean","description":"False for holdings the wallet never traded on Cielo (transferred in, airdropped, bought elsewhere); their cost-basis and PnL fields are zero."},"cost_basis_carried":{"type":"boolean","description":"True when the cost basis was carried over from another wallet in the same request that bought the tokens and transferred them here."}}}}}}
```

## The WalletTokenPosition object

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"components":{"schemas":{"WalletTokenPosition":{"type":"object","properties":{"chain":{"type":"string"},"wallet":{"type":"string"},"token_address":{"type":"string"},"token_symbol":{"type":"string"},"token_name":{"type":"string"},"platform":{"type":"string","description":"The token launch platform code."},"platform_ui":{"type":"string","description":"The human-readable token launch platform name."},"collateral":{"type":"string","description":"The token the position was traded against."},"bought_usd":{"type":"number"},"bought_native":{"type":"number"},"bought_amount":{"type":"number"},"sold_usd":{"type":"number"},"sold_native":{"type":"number"},"sold_amount":{"type":"number"},"sold_fees_usd":{"type":"number"},"sold_fees_native":{"type":"number"},"holding_usd":{"type":"number"},"holding_native":{"type":"number"},"holding_amount":{"type":"number"},"holding_raw":{"type":"string","description":"The holding in the token's smallest unit."},"realized_profit_usd":{"type":"number"},"realized_profit_native":{"type":"number"},"realized_profit_roi":{"type":"number"},"realized_profit_roi_native":{"type":"number"},"unrealized_profit_usd":{"type":"number"},"unrealized_profit_native":{"type":"number"},"unrealized_profit_roi":{"type":"number"},"unrealized_profit_roi_native":{"type":"number"},"total_profit_usd":{"type":"number"},"total_profit_native":{"type":"number"},"total_profit_roi":{"type":"number"},"total_profit_roi_native":{"type":"number"},"current_price_usd":{"type":"number"},"current_price_native":{"type":"number"},"market_cap":{"type":"number"},"avg_buy_price_usd":{"type":"number"},"avg_buy_price_native":{"type":"number"},"avg_sell_price_usd":{"type":"number"},"avg_sell_price_native":{"type":"number"},"avg_buy_market_cap_usd":{"type":"number"},"avg_sell_market_cap_usd":{"type":"number"},"last_trade_timestamp":{"type":"integer","description":"Unix timestamp of the wallet's last trade in this token."},"migrated_at":{"type":"integer","nullable":true,"description":"Unix timestamp of the token's migration off its launchpad, if any."},"has_cost_basis":{"type":"boolean","description":"False for holdings the wallet never traded on Cielo (transferred in, airdropped, bought elsewhere); their cost-basis and PnL fields are zero."},"cost_basis_carried":{"type":"boolean","description":"True when the cost basis was carried over from another wallet in the same request that bought the tokens and transferred them here."}}}}}}
```
