> 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/feed.md).

# Feed

The on-chain activity feed — swaps, transfers, LP, lending, NFT and other transactions of the wallets you track or query, across EVM chains and Solana.

## Feed

> This endpoint retrieves a feed of transactions based on specified query parameters.\
> With \`includeMarketCap=true\` the response also includes the market capitalization of tokens; this doubles the cost of the request.\
> \### Filters\
> \- \*\*Wallet Address\*\*: Filter transactions by wallet address.\
> \- \*\*Number of Transactions (limit)\*\*: Specify the number of transactions to retrieve.\
> \- \*\*Specific Lists\*\*: Filter transactions by specific lists.\
> \- \*\*Chains\*\*: Filter transactions by chains.\
> \- \*\*Transaction Types\*\*: Filter transactions by transaction types.\
> \- \*\*Tokens\*\*: Filter transactions by tokens.\
> \- \*\*Minimum USD Value\*\*: Filter transactions by minimum USD value.\
> \- \*\*Maximum USD Value\*\*: Filter transactions by maximum USD value.\
> \- \*\*Starting Point\*\*: Specify the starting point of the feed.\
> \- \*\*New Trades\*\*: Filter transactions by new trades.\
> \### Supported Chains\
> All chains returned by \`/api/v1/chains\`: EVM chains, Solana, Hyperliquid, Sui, Tron and Bitcoin.\
> \### Cost\
> \- \*\*Cost per request\*\*: 5 credits\
> \- \*\*Narrow query\*\*: 3 credits. A query that filters by \`chains\` or \`txTypes\` and has exactly one wallet, one chain or one transaction type.\
> \- \*\*\`includeMarketCap=true\`\*\*: doubles the price (10 or 6 credits).\
> \### Available Plans\
> Available on the following plans:\
> \- Free\
> \- Builder\
> \- Architect\
> \- Enterprise<br>

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"tags":[{"name":"Feed","description":"The on-chain activity feed — swaps, transfers, LP, lending, NFT and other transactions of the wallets you track or query, across EVM chains and Solana."}],"servers":[{"url":"https://api.cielo.finance","description":"Endpoint"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","in":"header","name":"X-API-KEY"}},"responses":{"FeedResponse":{"description":"Successfull Feed response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feed"}}}}},"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"]},"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"]}}},"paths":{"/api/v1/feed":{"get":{"tags":["Feed"],"summary":"Feed","description":"This endpoint retrieves a feed of transactions based on specified query parameters.\nWith `includeMarketCap=true` the response also includes the market capitalization of tokens; this doubles the cost of the request.\n### Filters\n- **Wallet Address**: Filter transactions by wallet address.\n- **Number of Transactions (limit)**: Specify the number of transactions to retrieve.\n- **Specific Lists**: Filter transactions by specific lists.\n- **Chains**: Filter transactions by chains.\n- **Transaction Types**: Filter transactions by transaction types.\n- **Tokens**: Filter transactions by tokens.\n- **Minimum USD Value**: Filter transactions by minimum USD value.\n- **Maximum USD Value**: Filter transactions by maximum USD value.\n- **Starting Point**: Specify the starting point of the feed.\n- **New Trades**: Filter transactions by new trades.\n### Supported Chains\nAll chains returned by `/api/v1/chains`: EVM chains, Solana, Hyperliquid, Sui, Tron and Bitcoin.\n### Cost\n- **Cost per request**: 5 credits\n- **Narrow query**: 3 credits. A query that filters by `chains` or `txTypes` and has exactly one wallet, one chain or one transaction type.\n- **`includeMarketCap=true`**: doubles the price (10 or 6 credits).\n### Available Plans\nAvailable on the following plans:\n- Free\n- Builder\n- Architect\n- Enterprise\n","operationId":"getFeed","parameters":[{"name":"wallet","in":"query","description":"Filter the feed by a specific wallet address.","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Limit the number of transactions returned in the feed. The maximum limit is 100.","required":false,"schema":{"type":"integer"}},{"name":"list","in":"query","description":"Filter transactions by a specific List ID.","required":false,"schema":{"type":"integer"}},{"name":"chains","in":"query","description":"Filter transactions by specific blockchain chains (e.g. ethereum), comma-separated for multiple values (e.g. ethereum,polygon). The authoritative live list of supported chains is available at `GET /api/v1/chains` — the `enum` below is a snapshot and may lag behind newly added networks.\n","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string","enum":["solana","base","ethereum","abstract","arbitrum","aurora","avalanche","berachain","bitcoin","blast","bnb","gnosis","hyperevm","hyperliquid","ink","linea","mantle","megaeth","monad","optimism","plasma","polygon","pulsechain","robinhood","scroll","sonic","stable","story","sui","tempo","tron","unichain","zksync"]}}},{"name":"txTypes","in":"query","description":"Filter transactions by types (e.g. swap, nft_trade), comma-separated for multiple values (e.g, swap,transfer,nft_trade)","required":false,"style":"form","explode":false,"schema":{"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"]}}},{"name":"tokens","in":"query","description":"Filter transactions by specific tokens, identified by either their address or symbol , comma-separated for multiple values (e.g, LINK,BITCOIN)","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"minUSD","in":"query","description":"Set a minimum USD value for transactions. Default - 0","required":false,"schema":{"type":"number"}},{"name":"maxUSD","in":"query","description":"Set a maximum USD value for transactions. Default - 0","required":false,"schema":{"type":"number"}},{"name":"newTrades","in":"query","description":"Filter transactions by new trades.","required":false,"schema":{"type":"boolean"}},{"name":"startFrom","in":"query","description":"Set value from response 'paging.next_object_id' to get next page.","required":false,"schema":{"type":"string"}},{"name":"fromTimestamp","in":"query","description":"Filter transactions from a specific UNIX timestamp.","required":false,"schema":{"type":"integer"}},{"name":"toTimestamp","in":"query","description":"Filter transactions to a specific UNIX timestamp.","required":false,"schema":{"type":"integer"}},{"name":"includeMarketCap","in":"query","description":"Include market capitalization of tokens in the response. Doubles the cost of the request.","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"$ref":"#/components/responses/FeedResponse"},"202":{"description":"Accepted - Data is not ready yet. Retry in 10 seconds.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Bad Request - The request was unacceptable, often due to missing a required parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden - The client does not have access rights to the content.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error - Something went wrong on the server's end.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
