{
  "openapi": "3.0.0",
  "info": {
    "title": "Cielo Public API",
    "description": "Programmatic access to the on-chain data that powers Cielo Finance — the wallet activity feed, wallet PnL and trading stats, token metadata, prices and safety checks, wallet tags and related wallets, portfolio tracking, and on-chain trading. Authenticate with an API key sent in the X-API-KEY header. Each endpoint notes its credit cost and the plans it is available on.",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.cielo.finance",
      "description": "Endpoint"
    }
  ],
  "security": [
    {
      "api_key": []
    }
  ],
  "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"
            },
            "example": "0x0f9d76acdbc4417b026f876be1e2042e45f3bcd2"
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Limit the number of transactions returned in the feed. The maximum limit is 100.",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "example": 10
          },
          {
            "name": "list",
            "in": "query",
            "description": "Filter transactions by a specific List ID.",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "example": 1
          },
          {
            "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"
                ]
              }
            },
            "example": [
              "ethereum",
              "base",
              "arbitrum"
            ]
          },
          {
            "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"
            },
            "example": 100
          },
          {
            "name": "maxUSD",
            "in": "query",
            "description": "Set a maximum USD value for transactions. Default - 0",
            "required": false,
            "schema": {
              "type": "number"
            },
            "example": 1000
          },
          {
            "name": "newTrades",
            "in": "query",
            "description": "Filter transactions by new trades.",
            "required": false,
            "schema": {
              "type": "boolean"
            },
            "example": true
          },
          {
            "name": "startFrom",
            "in": "query",
            "description": "Set value from response 'paging.next_object_id' to get next page.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "NjUyZDFlOTZjYTU1MTNjM2M0NzAyMjk5XzE2OTc0NTU3NjM"
          },
          {
            "name": "fromTimestamp",
            "in": "query",
            "description": "Filter transactions from a specific UNIX timestamp.",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "example": 1630000000000
          },
          {
            "name": "toTimestamp",
            "in": "query",
            "description": "Filter transactions to a specific UNIX timestamp.",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "example": 1630000000000
          },
          {
            "name": "includeMarketCap",
            "in": "query",
            "description": "Include market capitalization of tokens in the response. Doubles the cost of the request.",
            "required": false,
            "schema": {
              "type": "boolean"
            },
            "example": true
          }
        ],
        "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/{wallet}/pnl/tokens": {
      "get": {
        "tags": [
          "Wallet"
        ],
        "summary": "Token PNL",
        "description": "This endpoint retrieves a PnL values for a specified wallet by different tokens.\n### Cost per Request\nCost per request = 5 credits.\n### Available Plans\nAvailable on the following plans:\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "getTokensPNL",
        "parameters": [
          {
            "name": "wallet",
            "in": "path",
            "description": "Get P&L values for wallet.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0x0f9d76acdbc4417b026f876be1e2042e45f3bcd2"
          },
          {
            "name": "chain",
            "in": "query",
            "description": "Filter data by specific blockchain chains (e.g. ethereum), comma-separated for multiple values (e.g, ethereum,polygon)",
            "required": false,
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "example": [
              "ethereum",
              "base",
              "arbitrum"
            ]
          },
          {
            "name": "timeframe",
            "in": "query",
            "description": "Set time range for filtering data. Supported options - 1d, 7d, 30d and max. Default - max timeframe.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "5d"
          },
          {
            "name": "next_object",
            "in": "query",
            "description": "Next page for pagination.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": 4
          },
          {
            "name": "token",
            "in": "query",
            "description": "Filter data by specific tokens (e.g. PEPECAT or FfhArvgv8WB7eZ6qwENMouJRzcVpQVDoDtTuHrCk4Cxi), comma-separated for multiple values (e.g, usdc,usdt). Symbols are matched case-insensitively; addresses are matched as-is.",
            "required": false,
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "example": [
              "PEPECAT",
              "FfhArvgv8WB7eZ6qwENMouJRzcVpQVDoDtTuHrCk4Cxi"
            ]
          },
          {
            "name": "cex_transfers",
            "in": "query",
            "description": "Include cex transfers for calculating P&L. Default - false.",
            "required": false,
            "schema": {
              "type": "boolean"
            },
            "example": true
          },
          {
            "name": "active_positions_only",
            "in": "query",
            "description": "Filter to show only active positions. Default - false.",
            "required": false,
            "schema": {
              "type": "boolean"
            },
            "example": true
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/TokensPNLResponse"
          },
          "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/{wallet}/pnl/nfts": {
      "get": {
        "tags": [
          "Wallet"
        ],
        "summary": "NFT PNL",
        "description": "This endpoint retrieves the PnL value for an NFT collection on Ethereum.\n### Cost per Request\nCost per request = 5 credits.\n### Available Plans\nAvailable on the following plans:\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "getNftsPNL",
        "parameters": [
          {
            "name": "wallet",
            "in": "path",
            "description": "Get NFT P&L values for wallet.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0x0f9d76acdbc4417b026f876be1e2042e45f3bcd2"
          },
          {
            "name": "timeframe",
            "in": "query",
            "description": "Set time range for filtering data. Supported options - 1d, 7d, 30d and max. Default - max timeframe.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "5d"
          },
          {
            "name": "next_object",
            "in": "query",
            "description": "Next page for pagination.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": 4
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/NftsPnLResponse"
          },
          "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/{wallet}/pnl/total-stats": {
      "get": {
        "tags": [
          "Wallet"
        ],
        "summary": "Aggregated Token PNL",
        "description": "This endpoint retrieves aggregated PnL stats for a specified wallet.\n### Cost per Request\nCost per request = 20 credits.\n### Available Plans\nAvailable on the following plans:\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "getTotalStats",
        "parameters": [
          {
            "name": "wallet",
            "in": "path",
            "description": "Get tags associated with wallet.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0x0f9d76acdbc4417b026f876be1e2042e45f3bcd2"
          },
          {
            "name": "chains",
            "in": "query",
            "description": "Filter transactions by specific blockchain chains (e.g. ethereum), comma-separated for multiple values (e.g, ethereum,polygon)",
            "required": false,
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "example": [
              "ethereum",
              "base",
              "arbitrum"
            ]
          },
          {
            "name": "timeframe",
            "in": "query",
            "description": "Set time range for filtering data. Supported options - 1d, 7d, 30d and max. Default - max timeframe.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "7d"
          },
          {
            "name": "cex_transfers",
            "in": "query",
            "description": "Include CEX transfers in the response.",
            "required": false,
            "schema": {
              "type": "boolean"
            },
            "example": true
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/TotalStatsResponse"
          },
          "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/{wallet}/tags": {
      "get": {
        "tags": [
          "Tags"
        ],
        "summary": "Tags",
        "deprecated": true,
        "x-deprecated-replacement": "/api/v1/tags",
        "description": "# This endpoint is deprecated. Please use the `/api/v1/tags` endpoint instead.\nThis endpoint retrieves tags associated with a specific wallet address. Tags provide insights into wallet activity, such as NFT trading volume or participation in DeFi protocols.\n### Cost per Request\nCost per request = 5 credits.\n### Available Plans\nAvailable on the following plans:\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "getWalletTags",
        "parameters": [
          {
            "name": "wallet",
            "in": "path",
            "description": "Get tags associated with wallet.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0x0f9d76acdbc4417b026f876be1e2042e45f3bcd2"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/TagsResponse"
          },
          "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/{wallet}/related-wallets": {
      "get": {
        "tags": [
          "Wallet"
        ],
        "summary": "Related Wallets",
        "description": "This endpoint retrieves a list of wallets related to the specified wallet address. Related wallets are determined based on shared activity, such as token transfers, NFT trades, or participation in DeFi protocols.\n### Cost per Request\nCost per request = 10 credits.\n### Available Plans\nAvailable on the following plans:\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "getRelatedWallets",
        "parameters": [
          {
            "name": "wallet",
            "in": "path",
            "description": "Get related wallets for wallet.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0x0f9d76acdbc4417b026f876be1e2042e45f3bcd2"
          },
          {
            "name": "sort_criteria",
            "in": "query",
            "description": "Sort wallets by the specified criteria. Volume uses total USD received plus sent.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "volume_asc",
                "volume_desc",
                "inflow_asc",
                "inflow_desc",
                "outflow_asc",
                "outflow_desc",
                "transactions_asc",
                "transactions_desc"
              ]
            },
            "example": "inflow_asc"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/RelatedWalletsResponse"
          },
          "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/tags": {
      "get": {
        "tags": [
          "Tags"
        ],
        "summary": "Wallets Tags",
        "description": "This endpoint retrieves tags associated with a specific wallet address.  Tags provide insights into wallet activity.\nNote, tags will only be returned for wallets indexed by the Cielo engine.\n### Cost per Request\nCost per request = 5 credits.\n### Available Plans\nAvailable on the following plans:\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "getWalletsTags",
        "parameters": [
          {
            "name": "wallet",
            "in": "query",
            "description": "Get tags associated with wallets in the list. Maximum of 50 wallets.",
            "required": true,
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "example": [
              "0x0f9d76acdbc4417b026f876be1e2042e45f3bcd2"
            ]
          }
        ],
        "responses": {
          "200": {
            "description": "Successfull Wallets Tags response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WalletsTags"
                }
              }
            }
          },
          "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/tags/wallets": {
      "get": {
        "tags": [
          "Tags"
        ],
        "summary": "Wallets by Tag",
        "description": "This endpoint retrieves wallets associated with a specific tag. Tags provide insights into wallet activity.\n### Cost per Request\nCost per request = 10 credits.\n### Available Plans\nAvailable on the following plans:\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "getWalletsByTag",
        "parameters": [
          {
            "name": "tags",
            "in": "query",
            "description": "Filter wallets by a specific tag.",
            "required": true,
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/TagTypes"
              }
            },
            "example": [
              "new_wallet",
              "flipper",
              "honeypot"
            ]
          },
          {
            "name": "wallet_type",
            "in": "query",
            "description": "Filter wallets by a specific wallet type.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "evm",
                "solana"
              ]
            },
            "example": "solana"
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The number of wallets to return. The default is 20. The maximum value is 50.",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "example": 10
          },
          {
            "name": "next_object",
            "in": "query",
            "description": "Next page for pagination.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": 4
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/WalletsByTagResponse"
          },
          "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/tracked-wallets/address/{wallet}": {
      "get": {
        "tags": [
          "Wallet Management"
        ],
        "summary": "Get Wallet By Address",
        "description": "This endpoint retrieves a wallet by its address.\nPlans Included = Free, Builder, Architect Cost per request = 5 credits.\n",
        "operationId": "getWalletByAddress",
        "parameters": [
          {
            "name": "wallet",
            "in": "path",
            "description": "The address of the wallet to retrieve.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": 1.0392900530792776e+47
          }
        ],
        "responses": {
          "200": {
            "description": "Successfull Get Wallet By Address response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetWalletByAddress"
                }
              }
            }
          },
          "404": {
            "description": "Wallet not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/tracked-wallets": {
      "get": {
        "tags": [
          "Wallet Management"
        ],
        "summary": "Get Tracked Wallets",
        "description": "This endpoint retrieves a list of wallets that are being tracked. Tracked wallets are wallets that are being monitored for activity, such as token transfers, NFT trades, or participation in DeFi protocols.\nPlans Included = Free, Builder, Architect Cost per request = 5 credits.\n",
        "operationId": "getTrackedWallets",
        "parameters": [
          {
            "name": "next_object",
            "in": "query",
            "description": "Next page for pagination.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": 4
          },
          {
            "name": "list_id",
            "in": "query",
            "description": "The ID of the list to filter by.",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "example": 123
          }
        ],
        "responses": {
          "200": {
            "description": "Successfull Get Tracked Wallets response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetTrackedWallets"
                }
              }
            }
          },
          "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"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Wallet Management"
        ],
        "summary": "Add Tracked Wallet",
        "description": "This endpoint adds a wallet to the list of tracked wallets. Tracked wallets are wallets that are being monitored for activity, such as token transfers, NFT trades, or participation in DeFi protocols.\nYou can optionally configure notification settings including: - Telegram bot assignment for real-time alerts - Discord channel integration - Minimum USD threshold for notifications - Specific transaction types and chains to monitor\nPlans Included = Free, Builder, Architect Cost per request = 5 credits.\n",
        "operationId": "addTrackedWallet",
        "requestBody": {
          "description": "The wallet information to be tracked",
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "wallet": {
                    "type": "string",
                    "description": "The address of the wallet to be tracked",
                    "example": "0x1234567890abcdef1234567890abcdef12345678"
                  },
                  "label": {
                    "type": "string",
                    "description": "A label for the tracked wallet",
                    "example": "My Trading Wallet"
                  },
                  "list_id": {
                    "type": "integer",
                    "description": "The ID of the list to add the wallet to",
                    "example": 123
                  },
                  "bundle_id": {
                    "type": "integer",
                    "description": "Bundle ID (alternative to list_id)",
                    "example": 123
                  },
                  "min_amount_usd": {
                    "type": "number",
                    "description": "Minimum USD value threshold for notifications",
                    "example": 100
                  },
                  "filters": {
                    "type": "array",
                    "description": "Transaction type filters as integers",
                    "items": {
                      "type": "integer"
                    },
                    "example": [
                      1,
                      2,
                      3
                    ]
                  },
                  "chains": {
                    "type": "array",
                    "description": "Blockchain network IDs to monitor",
                    "items": {
                      "type": "integer"
                    },
                    "example": [
                      1,
                      137,
                      42161
                    ]
                  },
                  "new_trades": {
                    "type": "boolean",
                    "description": "Enable notifications for new trades",
                    "example": true
                  },
                  "telegram_bot_id": {
                    "type": "integer",
                    "description": "Telegram bot ID for notifications",
                    "example": 12345
                  },
                  "discord_channel_id": {
                    "type": "string",
                    "description": "Discord channel ID for notifications",
                    "example": "1234567890123456789"
                  }
                },
                "required": [
                  "wallet",
                  "label"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successfull Add Tracked Wallets response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AddTrackedWallet"
                }
              }
            }
          },
          "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"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Wallet Management"
        ],
        "summary": "Remove Tracked Wallets",
        "description": "This endpoint removes a wallet from the list of tracked wallets. Tracked wallets are wallets that are being monitored for activity, such as token transfers, NFT trades, or participation in DeFi protocols.\nPlans Included = Free, Builder, Architect Cost per request = 5 credits.\n",
        "operationId": "removeTrackedWallets",
        "requestBody": {
          "description": "The IDs of the wallets to be removed from tracking",
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "wallet_ids": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    },
                    "description": "The list of wallet IDs to be removed from tracking"
                  }
                },
                "required": [
                  "wallet_ids"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successfull Delete Tracked Wallets response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeleteTrackedWallets"
                }
              }
            }
          },
          "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/tracked-wallets/{wallet_id}": {
      "put": {
        "tags": [
          "Wallet Management"
        ],
        "summary": "Update Tracked Wallet",
        "description": "This endpoint updates a tracked wallet. Tracked wallets are wallets that are being monitored for activity, such as token transfers, NFT trades, or participation in DeFi protocols.\nPlans Included = Free, Builder, Architect Cost per request = 5 credits.\n",
        "operationId": "updateTrackedWallet",
        "parameters": [
          {
            "name": "wallet_id",
            "in": "path",
            "description": "The ID of the wallet to update",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "example": 123
          }
        ],
        "requestBody": {
          "description": "The wallet information to be tracked",
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "wallet": {
                    "type": "string",
                    "description": "The address of the wallet to be tracked"
                  },
                  "label": {
                    "type": "string",
                    "description": "A label for the tracked wallet"
                  },
                  "list_id": {
                    "type": "integer",
                    "description": "The ID of the list to add the wallet to"
                  }
                },
                "required": [
                  "wallet",
                  "label"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successfull Update Tracked Wallets response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UpdateTrackedWallet"
                }
              }
            }
          },
          "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/tracked-wallets/telegram-bots": {
      "get": {
        "tags": [
          "Wallet Management"
        ],
        "summary": "Get Available Telegram Bots",
        "description": "This endpoint returns a list of all available Telegram bots that can be used for wallet notifications when adding or updating tracked wallets.\nOnly bots that are available (available=true) are included in the response. This includes both enabled and disabled bots.\nEach bot has a unique ID that should be used in the telegram_bot_id field when configuring wallet notifications.\nPlans Included = Builder, Architect, Whale Cost per request = 5 credits.\n",
        "operationId": "getTelegramBots",
        "responses": {
          "200": {
            "description": "Successful Get Telegram Bots response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "ok"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "bots": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "oneOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "integer"
                                  }
                                ],
                                "description": "The unique ID of the telegram bot (can be string or integer)",
                                "example": "12345"
                              },
                              "label": {
                                "type": "string",
                                "description": "Display label for the bot",
                                "example": "Whale Alerts"
                              },
                              "name": {
                                "type": "string",
                                "description": "The name of the bot",
                                "example": "whale_alerts_bot"
                              },
                              "disabled": {
                                "type": "boolean",
                                "description": "Whether bot is disabled",
                                "example": false
                              },
                              "plan": {
                                "type": "string",
                                "description": "Plan type required for this bot",
                                "example": "PREMIUM"
                              },
                              "link": {
                                "type": "string",
                                "description": "Direct telegram link",
                                "example": "https://t.me/whale_alerts_bot"
                              },
                              "default": {
                                "type": "boolean",
                                "description": "Whether this is the default bot",
                                "example": false
                              },
                              "is_custom": {
                                "type": "boolean",
                                "description": "Whether this is a custom bot",
                                "example": false
                              },
                              "usage": {
                                "type": "string",
                                "description": "Bot usage level",
                                "example": "low"
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/tracked-wallets/{wallet}": {
      "put": {
        "tags": [
          "Wallet Management"
        ],
        "summary": "Update Tracked Wallet v2",
        "description": "This endpoint updates a specified tracked wallet.\nPlans Included = Builder, Architect, Enterprise Cost per request = 5 credits.\n",
        "operationId": "updateTrackedWalletV2",
        "parameters": [
          {
            "name": "wallet",
            "in": "path",
            "description": "The address of the wallet to update",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": 1.0392900530792776e+47
          }
        ],
        "requestBody": {
          "description": "Wallet settings to update",
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "label": {
                    "type": "string"
                  },
                  "list_id": {
                    "type": "integer"
                  },
                  "min_usd": {
                    "type": "number"
                  },
                  "tx_types": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "chains": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "new_trades": {
                    "type": "boolean"
                  },
                  "telegram_bot": {
                    "type": "string"
                  },
                  "discord_channel": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Update Tracked Wallet response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UpdateTrackedWallet"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Wallet not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/lists/all": {
      "get": {
        "tags": [
          "Lists"
        ],
        "summary": "Get all wallets lists",
        "description": "This endpoint retrieves public wallets lists.\n### Cost per Request\nCost per request = 5 credits.\n### Available Plans\nAvailable on the following plans:\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "getAllLists",
        "parameters": [
          {
            "name": "follow_only",
            "in": "query",
            "description": "Filter lists by followed status.",
            "required": false,
            "schema": {
              "type": "boolean"
            },
            "example": true
          },
          {
            "name": "order",
            "in": "query",
            "description": "Order lists by creation date.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "popular",
                "new"
              ]
            },
            "example": "popular"
          },
          {
            "name": "next_object",
            "in": "query",
            "description": "Next page for pagination.",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetAllWalletsListsResponse"
                }
              }
            }
          },
          "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/lists/": {
      "get": {
        "tags": [
          "Lists"
        ],
        "summary": "Get all lists for a user",
        "description": "This endpoint retrieves user's wallets lists.\n### Cost per Request\nCost per request = 5 credits.\n### Available Plans\nAvailable on the following plans:\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "getUserLists",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetUserListsResponse"
                }
              }
            }
          },
          "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"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Lists"
        ],
        "summary": "Add a list",
        "description": "This endpoint creates a new list for a user.\n### Cost per Request\nCost per request = 5 credits.\n### Available Plans\nAvailable on the following plans:\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "addUserList",
        "requestBody": {
          "description": "The list to add",
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateUserListRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateUserListResponse"
                }
              }
            }
          },
          "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/lists/{list_id}": {
      "put": {
        "tags": [
          "Lists"
        ],
        "summary": "Update a list",
        "description": "This endpoint updates a user's list.\n### Cost per Request\nCost per request = 5 credits.\n### Available Plans\nAvailable on the following plans:\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "updateUserList",
        "parameters": [
          {
            "name": "list_id",
            "in": "path",
            "description": "The ID of the list to update",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "requestBody": {
          "description": "The list to update",
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateUserListRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UpdateUserListResponse"
                }
              }
            }
          },
          "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"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Lists"
        ],
        "summary": "Delete a list",
        "description": "This endpoint deletes a user's list.\n### Cost per Request\nCost per request = 5 credits.\n### Available Plans\nAvailable on the following plans:\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "deleteUserList",
        "parameters": [
          {
            "name": "list_id",
            "in": "path",
            "description": "The ID of the list to update",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "delete_wallets",
            "in": "query",
            "description": "Delete wallets in the list",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeleteUserListResponse"
                }
              }
            }
          },
          "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/lists/{list_id}/toggle-follow": {
      "put": {
        "tags": [
          "Lists"
        ],
        "summary": "Toggle follow a list",
        "description": "This endpoint toggles follow a list for a user.\n### Cost per Request\nCost per request = 5 credits.\n### Available Plans\nAvailable on the following plans:\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "toggleFollowList",
        "parameters": [
          {
            "name": "list_id",
            "in": "path",
            "description": "The ID of the list to follow",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ToggleFollowListResponse"
                }
              }
            }
          },
          "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/token/metadata": {
      "get": {
        "tags": [
          "Token"
        ],
        "summary": "Token metadata",
        "description": "This endpoint retrieves metadata for a specific token.\n### Cost per Request\nCost per request = 2 credits.\n### Available Plans:\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "getTokenMetadata",
        "parameters": [
          {
            "name": "chain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "solana",
                "ethereum",
                "base",
                "hyperevm",
                "robinhood",
                "arc"
              ]
            },
            "example": "solana"
          },
          {
            "name": "token_address",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "address"
            },
            "example": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TokenMetadataResponse"
                }
              }
            }
          },
          "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"
                }
              }
            }
          },
          "404": {
            "description": "Not Found - Token not found.",
            "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/token/price": {
      "get": {
        "tags": [
          "Token"
        ],
        "summary": "Token price",
        "description": "This endpoint retrieves price for a specific token.\n### Cost per Request\nCost per request = 2 credits.\n### Available Plans:\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "getTokenPrice",
        "parameters": [
          {
            "name": "chain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "solana",
                "ethereum",
                "base",
                "hyperevm",
                "robinhood",
                "arc"
              ]
            },
            "example": "solana"
          },
          {
            "name": "token_address",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "address"
            },
            "example": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TokenPriceResponse"
                }
              }
            }
          },
          "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"
                }
              }
            }
          },
          "404": {
            "description": "Not Found - Token not found.",
            "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/token/stats": {
      "get": {
        "tags": [
          "Token"
        ],
        "summary": "Token stats",
        "description": "This endpoint retrieves stats of a specified token.\n### Cost per Request\nCost per request = 10 credits.\n### Available Plans:\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "getTokenStats",
        "parameters": [
          {
            "name": "chain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "solana",
                "ethereum",
                "base",
                "hyperevm",
                "robinhood",
                "arc"
              ]
            },
            "example": "ethereum"
          },
          {
            "name": "token_address",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "address"
            },
            "example": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN"
          },
          {
            "name": "include_liquidity",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": true
            },
            "description": "When false, skips the upstream liquidity evaluation to return faster. The liquidity, pools and is_spam fields stay empty in the response. Pair with /api/v1/token/stats-liquidity to fetch the omitted fields separately.\n",
            "example": false
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TokenStatsResponse"
                }
              }
            }
          },
          "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"
                }
              }
            }
          },
          "404": {
            "description": "Not Found - Token not found.",
            "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/token/stats-liquidity": {
      "get": {
        "tags": [
          "Token"
        ],
        "summary": "Token liquidity slice",
        "description": "Liquidity portion of /api/v1/token/stats. Designed to pair with /api/v1/token/stats?include_liquidity=false so callers can fetch the fast stats payload and the heavier liquidity slice in parallel.\n### Cost per Request\nCost per request = 10 credits.\n### Available Plans:\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "getTokenStatsLiquidity",
        "parameters": [
          {
            "name": "chain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "solana",
                "ethereum",
                "base",
                "hyperevm",
                "robinhood",
                "arc"
              ]
            },
            "example": "ethereum"
          },
          {
            "name": "token_address",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "address"
            },
            "example": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TokenStatsLiquidityResponse"
                }
              }
            }
          },
          "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"
                }
              }
            }
          },
          "404": {
            "description": "Not Found - Token not found.",
            "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/token/checklist": {
      "get": {
        "tags": [
          "Token"
        ],
        "summary": "Token checklist",
        "description": "This endpoint retrieves safety and distribution checklist data for a specific token.\n### Cost per Request\nCost per request = 10 credits.\n### Available Plans:\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "getTokenChecklist",
        "parameters": [
          {
            "name": "chain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "solana",
                "ethereum",
                "base",
                "robinhood",
                "arc"
              ]
            },
            "example": "solana"
          },
          {
            "name": "token_address",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "address"
            },
            "example": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TokenChecklistResponse"
                }
              }
            }
          },
          "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"
                }
              }
            }
          },
          "404": {
            "description": "Not Found - Token not found.",
            "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/ws": {
      "get": {
        "tags": [
          "Web Socket"
        ],
        "summary": "WebSocket Connection",
        "description": "This endpoint sets up a WebSocket connection to receive updates on new transactions.\n\nOnce connected, the client can send command messages to the WebSocket in the following formats:\n### Subscribe to a feed:\nRefer to the `FeedSubscribeCommand` schema for the command structure.\n#### Subscribe to all feed events:\n```json\n{\n  \"type\": \"subscribe_feed\",\n}\n```\n#### Subscribe to feed with filters. Filters tx_types, chains, tokens, min_usd_value, new_trade are optional:\n```json\n{\n  \"type\": \"subscribe_feed\",\n  \"filter\": {\n      \"tx_types\": [\"transfer\", \"swap\"],\n      \"chains\": [\"eth\", \"bsc\"],\n      \"tokens\": [\"0x1234\", \"0x5678\"],\n      \"min_usd_value\": 1000,\n      \"new_trade\": true\n  }\n}\n```\n#### Subscribe to feed for an new trades:\n```json\n{\n  \"type\": \"subscribe_feed\",\n  \"filter\": {\n      \"new_trade\": true\n  }\n}\n```\n### Subscribe to feed for a certain list:\n```json\n{\n  \"type\": \"subscribe_feed\",\n  \"list_id\": 12345\n}\n```\n### Unsubscribe from a feed:\nRefer to the `FeedUnsubscribeCommand` schema for the command structure.\n```json\n{\n  \"type\": \"unsubscribe_feed\"\n}\n```\n### Subscribe to a wallet:\nRefer to the `WalletSubscribeCommand` schema for the command structure.\n#### Subscribe to all wallet events:\n```json\n{\n      \"type\": \"subscribe_wallet\",\n      \"wallet\": \"wallet-address\",\n}\n```\n#### Subscribe to wallet events with filters. Filters tx_types, chains, tokens, min_usd_value, new_trade are optional:\n```json\n{\n  \"type\": \"subscribe_wallet\",\n  \"wallet\": \"wallet-address\",\n  \"filter\": {\n      \"tx_types\": [\"transfer\", \"swap\"],\n      \"chains\": [\"ethereum\", \"bsc\"],\n      \"tokens\": [\"0x1234\", \"0x5678\"],\n      \"min_usd_value\": 1000,\n      \"new_trade\": true\n  }\n}\n```\n### Unsubscribe from a wallet:\nRefer to the `WalletUnsubscribeCommand` schema for the command structure.\n```json\n{\n  \"type\": \"unsubscribe_wallet\",\n  \"wallet\": \"wallet-address\"\n}\n```\nThe server will send back messages in the following schema:\n### Websocket Event Message:\nRefer to the `WebsocketEvent` schema for the message structure.\n```json\n{\n  \"type\": \"event_type\",\n  \"data\": {}\n}\n```\n### Supported Chains\nThe `chains` filter accepts the same chain identifiers used by the REST API. The authoritative live list is available at `GET /api/v1/chains` — any value not in that list will be rejected by the server when the command is validated.\n\n### Pricing Information\nEvery 10 messages sent over the WebSocket connection consume 1 credit.\n### Available Plans\nAvailable on the following plans:\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "getWebSocket",
        "responses": {
          "101": {
            "description": "Switching Protocols - The server has switched protocols in response to a client request.",
            "headers": {
              "Upgrade": {
                "description": "The protocol to which the server is switching.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "websocket"
                  ],
                  "default": "websocket"
                }
              },
              "Connection": {
                "description": "Indicates that the server is willing to upgrade the connection.",
                "schema": {
                  "type": "string",
                  "enum": [
                    "Upgrade"
                  ],
                  "default": "Upgrade"
                }
              },
              "Sec-WebSocket-Accept": {
                "description": "A WebSocket-specific header used in the WebSocket handshake.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/{wallet}/trading-stats": {
      "get": {
        "tags": [
          "Wallet"
        ],
        "summary": "Trading Stats",
        "description": "Detailed performance statistics for a wallet's trading activity, including PnL, ROI, win rate, and trading behavior insights.\n### Cost per Request\nCost per request = 30 credits.\n### Available Plans\nAvailable on the following plans:\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "getTradingStats",
        "parameters": [
          {
            "name": "wallet",
            "in": "path",
            "description": "Get trading stats for wallet.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0x0f9d76acdbc4417b026f876be1e2042e45f3bcd2"
          },
          {
            "name": "days",
            "in": "query",
            "description": "Time period for trading stats (1d, 7d, 30d, max).",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "1d",
                "7d",
                "30d",
                "max"
              ]
            },
            "example": "7d"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/TradingStatsResponse"
          },
          "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/{wallet}/portfolio": {
      "get": {
        "tags": [
          "Wallet"
        ],
        "summary": "Wallet Portfolio",
        "description": "Retrieve the portfolio of a wallet.\nFor Solana wallets, the response also includes the native SOL balance.\nPortfolio assets with a total_usd_value of zero are not included in the response.\nAvailable chains:\n- Solana\n- EVM (Ethereum, Base, HyperEVM, Robinhood)\n### Cost per Request\nCost per request = 20 credits.\n### Available Plans\nAvailable on the following plans:\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "getWalletPortfolio",
        "parameters": [
          {
            "name": "wallet",
            "in": "path",
            "description": "Get portfolio for wallet.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0x0f9d76acdbc4417b026f876be1e2042e45f3bcd2"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WalletPortfolioResponse"
                }
              }
            }
          },
          "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/{wallet}/token-balance": {
      "get": {
        "tags": [
          "Wallet"
        ],
        "summary": "Token Balance",
        "description": "Retrieve the token balance for a wallet.\nAvailable chains:\n- Solana\n- EVM (Ethereum, Base, HyperEVM, Robinhood)\n### Cost per Request\nCost per request = 3 credits.\n### Available Plans\nAvailable on the following plans:\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "getTokenBalance",
        "parameters": [
          {
            "name": "wallet",
            "in": "path",
            "description": "Get token balance for wallet.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0x0f9d76acdbc4417b026f876be1e2042e45f3bcd2"
          },
          {
            "name": "token_address",
            "in": "query",
            "description": "The token address to get balance for.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0x6B175474E89094C44Da98b954EedeAC495271d0F"
          },
          {
            "name": "chain",
            "in": "query",
            "description": "The blockchain network (ethereum, base, or solana).",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "solana",
                "ethereum",
                "base",
                "hyperevm",
                "robinhood",
                "arc"
              ]
            },
            "example": "solana"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TokenBalanceResponse"
                }
              }
            }
          },
          "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/wallet/positions": {
      "get": {
        "tags": [
          "Wallet"
        ],
        "summary": "Wallet Token Positions",
        "description": "This endpoint retrieves per-token trading positions for one or more wallets: amounts bought and sold, current holdings, average buy and sell prices, and realized and unrealized PnL in USD and in the chain's native token.\nResults are paginated with a cursor: pass `paging.next_cursor` from the previous response as `next_cursor`.\n### Cost per Request\nCost per request = 3 credits.\n### Available Plans\nAvailable on the following plans:\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "getWalletTokenPositions",
        "parameters": [
          {
            "name": "chain",
            "in": "query",
            "description": "Chain to query. `all` returns positions from both Base and Solana.",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "base",
                "solana",
                "all"
              ]
            },
            "example": "solana"
          },
          {
            "name": "wallets",
            "in": "query",
            "description": "Comma-separated wallet addresses.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "9W7CCnAvviXzP9ToyfCBT4aYbn845HdZSWS7kZPZ96mg"
          },
          {
            "name": "token_addresses",
            "in": "query",
            "description": "Comma-separated token addresses to filter by.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "active_positions",
            "in": "query",
            "description": "Return only positions with a non-zero holding.",
            "required": false,
            "schema": {
              "type": "boolean"
            },
            "example": true
          },
          {
            "name": "collateral",
            "in": "query",
            "description": "Filter by the collateral the position was traded against.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort_by",
            "in": "query",
            "description": "Sort order.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "bought_usd_asc",
                "bought_usd_desc",
                "bought_native_asc",
                "bought_native_desc",
                "sold_usd_asc",
                "sold_usd_desc",
                "sold_native_asc",
                "sold_native_desc",
                "holding_usd_asc",
                "holding_usd_desc",
                "holding_native_asc",
                "holding_native_desc",
                "realized_profit_usd_asc",
                "realized_profit_usd_desc",
                "realized_profit_native_asc",
                "realized_profit_native_desc",
                "avg_buy_price_usd_asc",
                "avg_buy_price_usd_desc",
                "avg_buy_price_native_asc",
                "avg_buy_price_native_desc",
                "avg_sell_price_usd_asc",
                "avg_sell_price_usd_desc",
                "avg_sell_price_native_asc",
                "avg_sell_price_native_desc",
                "last_trade_timestamp_asc",
                "last_trade_timestamp_desc"
              ]
            },
            "example": "holding_usd_desc"
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of positions to return.",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "example": 50
          },
          {
            "name": "next_cursor",
            "in": "query",
            "description": "Cursor from the previous response's `paging.next_cursor`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WalletTokenPositionsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - `chain` is missing or invalid, or `sort_by` is invalid.",
            "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"
                }
              }
            }
          },
          "408": {
            "description": "Request Timeout",
            "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/{wallet}/enhanced-stats/aggregated": {
      "get": {
        "tags": [
          "Wallet"
        ],
        "summary": "Enhanced Aggregated Stats",
        "description": "This endpoint retrieves enhanced aggregated trading statistics for a specified wallet, including trade counts, buy/sell amounts, DEX distribution, holding times, and most traded tokens.\n### Cost per Request\nCost per request = 20 credits.\n### Available Plans\nAvailable on the following plans:\n- Whale\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "getWalletEnhancedAggregatedStats",
        "parameters": [
          {
            "name": "wallet",
            "in": "path",
            "description": "The wallet address to get enhanced aggregated stats for.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0x0f9d76acdbc4417b026f876be1e2042e45f3bcd2"
          },
          {
            "name": "days",
            "in": "query",
            "description": "Time range filter. Supported options - 1d, 7d, 30d and max.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "7d"
          },
          {
            "name": "from_timestamp",
            "in": "query",
            "description": "Unix timestamp for the start of the time range.",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "example": 1700000000
          },
          {
            "name": "to_timestamp",
            "in": "query",
            "description": "Unix timestamp for the end of the time range.",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "example": 1710000000
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - Invalid wallet address or query parameters.",
            "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/{wallet}/enhanced-stats/profitability-performance": {
      "get": {
        "tags": [
          "Wallet"
        ],
        "summary": "Profitability & Performance Stats",
        "description": "This endpoint retrieves profitability and performance statistics for a specified wallet, including win/loss trades, win rate, max profit/drawdown, win streaks, and holding distribution.\n### Cost per Request\nCost per request = 20 credits.\n### Available Plans\nAvailable on the following plans:\n- Whale\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "getWalletProfitabilityAndPerformance",
        "parameters": [
          {
            "name": "wallet",
            "in": "path",
            "description": "The wallet address to get profitability stats for.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0x0f9d76acdbc4417b026f876be1e2042e45f3bcd2"
          },
          {
            "name": "days",
            "in": "query",
            "description": "Time range filter. Supported options - 1d, 7d, 30d and max.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "7d"
          },
          {
            "name": "from_timestamp",
            "in": "query",
            "description": "Unix timestamp for the start of the time range.",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "example": 1700000000
          },
          {
            "name": "to_timestamp",
            "in": "query",
            "description": "Unix timestamp for the end of the time range.",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "example": 1710000000
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - Invalid wallet address or query parameters.",
            "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/enhanced-stats/aggregated": {
      "get": {
        "tags": [
          "Wallet"
        ],
        "summary": "Enhanced Aggregated Stats V2",
        "description": "This endpoint retrieves enhanced aggregated trading statistics with support for multi-bundle wallets via the multi_bundle_id parameter.\n### Cost per Request\nCost per request = 25 credits.\n### Available Plans\nAvailable on the following plans:\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "getWalletEnhancedAggregatedStatsV2",
        "parameters": [
          {
            "name": "wallet",
            "in": "query",
            "description": "The wallet address to get enhanced aggregated stats for.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "0x0f9d76acdbc4417b026f876be1e2042e45f3bcd2"
          },
          {
            "name": "multi_bundle_id",
            "in": "query",
            "description": "Multi-bundle ID to aggregate stats across multiple wallets.",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "example": 123
          },
          {
            "name": "days",
            "in": "query",
            "description": "Time range filter. Supported options - 1d, 7d, 30d and max.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "7d"
          },
          {
            "name": "from_timestamp",
            "in": "query",
            "description": "Unix timestamp for the start of the time range.",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "example": 1700000000
          },
          {
            "name": "to_timestamp",
            "in": "query",
            "description": "Unix timestamp for the end of the time range.",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "example": 1710000000
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - Invalid parameters.",
            "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/{wallet}/pnl/tokens-chart": {
      "get": {
        "tags": [
          "Wallet"
        ],
        "summary": "PnL Tokens Chart",
        "description": "This endpoint retrieves PnL time series chart data for a specified wallet, showing profit/loss over time with ROI calculations.\n### Cost per Request\nCost per request = 15 credits.\n### Available Plans\nAvailable on the following plans:\n- Whale\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "getTokensPnLChart",
        "parameters": [
          {
            "name": "wallet",
            "in": "path",
            "description": "The wallet address to get PnL chart data for.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0x0f9d76acdbc4417b026f876be1e2042e45f3bcd2"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "202": {
            "description": "Accepted - Data is not ready yet. Retry in 10 seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - Invalid wallet address or query parameters.",
            "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/{wallet}/pnl/month": {
      "get": {
        "tags": [
          "Wallet"
        ],
        "summary": "Monthly PnL",
        "description": "This endpoint retrieves monthly PnL data for a specified wallet, showing profit/loss aggregated by month.\n### Cost per Request\nCost per request = 5 credits.\n### Available Plans\nAvailable on the following plans:\n- Whale\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "getMonthlyPnL",
        "parameters": [
          {
            "name": "wallet",
            "in": "path",
            "description": "The wallet address to get monthly PnL data for.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0x0f9d76acdbc4417b026f876be1e2042e45f3bcd2"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "202": {
            "description": "Accepted - Data is not ready yet. Retry in 10 seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - Invalid wallet address or query parameters.",
            "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/trending-tokens": {
      "get": {
        "tags": [
          "Token"
        ],
        "summary": "Trending tokens",
        "description": "This endpoint retrieves the top trending tokens by unique wallet activity for the specified chain and interval.\n### Cost per Request\nCost per request = 20 credits.\n### Available Plans:\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "getTrendingTokens",
        "parameters": [
          {
            "name": "min_pro_traders",
            "in": "query",
            "required": false,
            "description": "Unsigned 64-bit integer (0 to 18446744073709551615). Inclusive minimum distinct Pro Trader count for the selected interval. Unavailable rows are excluded; min must not exceed max.",
            "schema": {
              "type": "integer",
              "minimum": 0
            }
          },
          {
            "name": "max_pro_traders",
            "in": "query",
            "required": false,
            "description": "Unsigned 64-bit integer (0 to 18446744073709551615). Inclusive maximum distinct Pro Trader count for the selected interval. Unavailable rows are excluded; min must not exceed max.",
            "schema": {
              "type": "integer",
              "minimum": 0
            }
          },
          {
            "name": "chain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "solana",
                "base",
                "all"
              ]
            },
            "description": "The blockchain network to get trending tokens for.",
            "example": "solana"
          },
          {
            "name": "interval",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "1m",
                "5m",
                "1h",
                "6h",
                "24h"
              ],
              "default": "1h"
            },
            "description": "The time window for trending calculation. Shorter intervals show more recent momentum; longer intervals show sustained trends. Defaults to 1h.\n",
            "example": "5m"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "description": "Maximum number of tokens to return.",
            "example": 20
          },
          {
            "name": "sort_by",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "pro_traders_asc",
                "pro_traders_desc",
                "mindshare_asc",
                "mindshare_desc",
                "market_cap_asc",
                "market_cap_desc",
                "holders_asc",
                "holders_desc",
                "liquidity_asc",
                "liquidity_desc",
                "volume_24h_asc",
                "volume_24h_desc",
                "transactions_asc",
                "transactions_desc",
                "whale_asc",
                "whale_desc",
                "popular_asc",
                "popular_desc",
                "net_flow_asc",
                "net_flow_desc",
                "fresh_wallets_asc",
                "fresh_wallets_desc",
                "avg_buy_asc",
                "avg_buy_desc",
                "price_change_asc",
                "price_change_desc",
                "age_asc",
                "age_desc",
                "bonding_curve_asc",
                "bonding_curve_desc",
                "unique_wallets_asc",
                "unique_wallets_desc"
              ]
            },
            "description": "Sort order for results.",
            "example": "market_cap_desc"
          },
          {
            "name": "next_cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Cursor for pagination."
          },
          {
            "name": "dex_paid",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            },
            "description": "Filter by DEX paid status."
          },
          {
            "name": "protocols",
            "in": "query",
            "required": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "description": "Filter by protocols."
          },
          {
            "name": "min_market_cap",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "Minimum market cap filter (USD)."
          },
          {
            "name": "max_market_cap",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "Maximum market cap filter (USD)."
          },
          {
            "name": "min_liquidity",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "Minimum liquidity filter (USD)."
          },
          {
            "name": "max_liquidity",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "Maximum liquidity filter (USD)."
          },
          {
            "name": "min_volume_24h",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "Minimum 24h volume filter (USD)."
          },
          {
            "name": "max_volume_24h",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "Maximum 24h volume filter (USD)."
          },
          {
            "name": "min_unique_wallets",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "description": "Minimum unique wallets filter."
          },
          {
            "name": "max_unique_wallets",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "description": "Maximum unique wallets filter."
          },
          {
            "name": "min_holders",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "description": "Minimum holders filter."
          },
          {
            "name": "max_holders",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "description": "Maximum holders filter."
          },
          {
            "name": "min_transactions",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "description": "Minimum transactions filter."
          },
          {
            "name": "max_transactions",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "description": "Maximum transactions filter."
          },
          {
            "name": "min_mindshare",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "Minimum mindshare filter."
          },
          {
            "name": "max_mindshare",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "Maximum mindshare filter."
          },
          {
            "name": "min_price_change",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "Minimum price change filter."
          },
          {
            "name": "max_price_change",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "Maximum price change filter."
          },
          {
            "name": "min_token_age",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Minimum token age filter."
          },
          {
            "name": "max_token_age",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Maximum token age filter."
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TrendingTokensResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - Invalid parameter.",
            "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"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/chains": {
      "get": {
        "tags": [
          "Chains"
        ],
        "summary": "Supported Chains",
        "description": "Returns the list of blockchain networks currently supported by the Cielo API. The list is the authoritative source for the `chains` query parameter used across endpoints such as `/api/v1/feed` and the WebSocket `subscribe_feed` / `subscribe_wallet` commands — any value not in this list will be rejected with `400 invalid chain`.\n\n### Cost\n\n- **Cost per request**: 0 credits (this endpoint is free; requests are not deducted\n  from your API credit quota)\n\n\n### Available Plans\n\nAvailable on all plans:\n\n- Free\n\n- Builder\n\n- Architect\n\n- Enterprise\n",
        "operationId": "getChains",
        "responses": {
          "200": {
            "description": "OK - Returns the list of supported chain identifiers.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChainsResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error - Something went wrong on the server's end.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/v2/token-flows": {
      "get": {
        "tags": [
          "Token"
        ],
        "summary": "Token Flows V2",
        "description": "Aggregated token flow data (buys, sells, net flow) across your tracked wallets — the wallet list belonging to the account that owns this API key. Includes platform information for Solana tokens.\n\nThe caller's wallet is derived server-side from the API key — clients do not need to provide it via a header.\n\n### Cost per Request\nCost per request = 5 credits.\n\n### Available Plans\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "getTokenFlowsV2",
        "parameters": [
          {
            "name": "last",
            "in": "query",
            "description": "Time period (1h, 6h, 24h, 7d, 30d). Default is 24h.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "1h",
                "6h",
                "24h",
                "7d",
                "30d"
              ]
            },
            "example": "24h"
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number for pagination. Default is 1.",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "example": 1
          },
          {
            "name": "list",
            "in": "query",
            "description": "Filter by list/bundle ID.",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "example": 123
          },
          {
            "name": "chain",
            "in": "query",
            "description": "Filter by blockchain chain (e.g. solana, ethereum), comma-separated for multiple values.",
            "required": false,
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "example": [
              "solana"
            ]
          },
          {
            "name": "sort_by",
            "in": "query",
            "description": "Sort field (net_flow_usd, buy_usd, sell_usd, wallets_num, trades_num). Default is net_flow_usd.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "net_flow_usd",
                "buy_usd",
                "sell_usd",
                "wallets_num",
                "trades_num"
              ]
            },
            "example": "net_flow_usd"
          },
          {
            "name": "order",
            "in": "query",
            "description": "Sort order (asc, desc). Default is desc.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "asc",
                "desc"
              ]
            },
            "example": "desc"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "ok"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "address": {
                                "type": "string",
                                "description": "Token contract address."
                              },
                              "symbol": {
                                "type": "string"
                              },
                              "name": {
                                "type": "string"
                              },
                              "chain": {
                                "type": "string",
                                "example": "solana"
                              },
                              "net_flow_usd": {
                                "type": "integer",
                                "format": "int64",
                                "description": "Net flow in USD (signed, integer rounded)."
                              },
                              "net_flow_amount": {
                                "type": "integer",
                                "format": "int64"
                              },
                              "buy_usd": {
                                "type": "integer",
                                "format": "int64"
                              },
                              "buy_amount": {
                                "type": "integer",
                                "format": "int64"
                              },
                              "sell_usd": {
                                "type": "integer",
                                "format": "int64"
                              },
                              "sell_amount": {
                                "type": "integer",
                                "format": "int64"
                              },
                              "avg_buy_usd": {
                                "type": "integer",
                                "format": "int64"
                              },
                              "avg_sell_usd": {
                                "type": "integer",
                                "format": "int64"
                              },
                              "wallets_num": {
                                "type": "integer"
                              },
                              "trades_num": {
                                "type": "integer"
                              },
                              "platform": {
                                "type": "string",
                                "description": "Platform code for Solana tokens (e.g. \"pump.fun\"). Omitted otherwise."
                              }
                            }
                          }
                        },
                        "paging": {
                          "type": "object",
                          "properties": {
                            "total_pages": {
                              "type": "integer"
                            },
                            "total_rows": {
                              "type": "integer"
                            },
                            "total_rows_in_page": {
                              "type": "integer"
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - The request was unacceptable, often due to a missing or invalid parameter."
          },
          "401": {
            "description": "Unauthorized - The API key is not associated with a wallet."
          },
          "403": {
            "description": "Forbidden - The API key plan does not allow access to this endpoint."
          },
          "500": {
            "description": "Internal Server Error - Something went wrong on the server's end."
          }
        }
      }
    },
    "/api/v2/new-token-flows": {
      "get": {
        "tags": [
          "Token"
        ],
        "summary": "New Token Flows",
        "description": "Aggregated token flow data for recently created tokens (within the last 24 hours) across your tracked wallets — the wallet list belonging to the account that owns this API key. Includes platform information for Solana tokens.\n\nThe caller's wallet is derived server-side from the API key — clients do not need to provide it via a header.\n\n### Cost per Request\nCost per request = 5 credits.\n\n### Available Plans\n- Builder\n- Architect\n- Enterprise\n",
        "operationId": "getNewTokenFlows",
        "parameters": [
          {
            "name": "last",
            "in": "query",
            "description": "Time period (1h, 6h, 24h). Default is 24h.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "1h",
                "6h",
                "24h"
              ]
            },
            "example": "24h"
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number for pagination. Default is 1.",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "example": 1
          },
          {
            "name": "list",
            "in": "query",
            "description": "Filter by list/bundle ID.",
            "required": false,
            "schema": {
              "type": "integer"
            },
            "example": 123
          },
          {
            "name": "chain",
            "in": "query",
            "description": "Filter by blockchain chain (e.g. solana, ethereum), comma-separated for multiple values.",
            "required": false,
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "example": [
              "solana"
            ]
          },
          {
            "name": "sort_by",
            "in": "query",
            "description": "Sort field (net_flow_usd, buy_usd, sell_usd, wallets_num, trades_num). Default is net_flow_usd.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "net_flow_usd",
                "buy_usd",
                "sell_usd",
                "wallets_num",
                "trades_num"
              ]
            },
            "example": "net_flow_usd"
          },
          {
            "name": "order",
            "in": "query",
            "description": "Sort order (asc, desc). Default is desc.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "asc",
                "desc"
              ]
            },
            "example": "desc"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "ok"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "items": {
                          "type": "array",
                          "items": {
                            "allOf": [
                              {
                                "$ref": "#/paths/~1api~1v2~1token-flows/get/responses/200/content/application~1json/schema/properties/data/properties/items/items"
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "timestamp": {
                                    "type": "integer",
                                    "format": "int64",
                                    "description": "Unix timestamp (seconds) of the token's first trade."
                                  }
                                }
                              }
                            ]
                          }
                        },
                        "paging": {
                          "$ref": "#/paths/~1api~1v2~1token-flows/get/responses/200/content/application~1json/schema/properties/data/properties/paging"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - The request was unacceptable, often due to a missing or invalid parameter."
          },
          "401": {
            "description": "Unauthorized - The API key is not associated with a wallet."
          },
          "403": {
            "description": "Forbidden - The API key plan does not allow access to this endpoint."
          },
          "500": {
            "description": "Internal Server Error - Something went wrong on the server's end."
          }
        }
      }
    },
    "/api/trading/wallets": {
      "get": {
        "tags": [
          "Trading Wallets"
        ],
        "summary": "Get Trading Wallets",
        "description": "Returns a list of trading wallets for the authenticated user. Trading wallets are custodial wallets used for executing trades through Cielo's trading infrastructure.\nPlans Included = Basic, Whale, ApiBasic, Builder, Architect, Enterprise Cost per request = 5 credits.\n",
        "operationId": "getTradingWallets",
        "parameters": [
          {
            "name": "chain",
            "in": "query",
            "description": "Blockchain chain filter (e.g. solana, base).",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "include_archived",
            "in": "query",
            "description": "Include archived wallets.",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": true
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of trading wallets",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "ok"
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/paths/~1api~1trading~1wallets/post/responses/200/content/application~1json/schema/properties/data"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request - chain is required",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Invalid API key or plan",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Trading Wallets"
        ],
        "summary": "Create Trading Wallet",
        "description": "Creates a new trading wallet for the authenticated user on the given chain.\nPlans Included = Basic, Whale, ApiBasic, Builder, Architect, Enterprise Cost per request = 10 credits.\n",
        "operationId": "createTradingWallet",
        "parameters": [
          {
            "name": "chain",
            "in": "query",
            "description": "Blockchain chain (e.g. solana, base). Defaults to solana.",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Created trading wallet",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "ok"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "address": {
                          "type": "string"
                        },
                        "wallet_name": {
                          "type": "string"
                        },
                        "is_default": {
                          "type": "boolean"
                        },
                        "is_enabled": {
                          "type": "boolean"
                        },
                        "is_archived": {
                          "type": "boolean"
                        },
                        "chain": {
                          "type": "string"
                        },
                        "balance": {
                          "type": "number"
                        },
                        "balance_usd": {
                          "type": "number"
                        },
                        "usdc_balance": {
                          "type": "number"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/trading/wallets/default": {
      "get": {
        "tags": [
          "Trading Wallets"
        ],
        "summary": "Get Default Trading Wallet",
        "description": "Returns the default trading wallet for the specified chain.\nPlans Included = Basic, Whale, ApiBasic, Builder, Architect, Enterprise Cost per request = 5 credits.\n",
        "operationId": "getDefaultTradingWallet",
        "parameters": [
          {
            "name": "chain",
            "in": "query",
            "description": "Blockchain chain (e.g. solana, base).",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Default trading wallet",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "ok"
                    },
                    "data": {
                      "$ref": "#/paths/~1api~1trading~1wallets/post/responses/200/content/application~1json/schema/properties/data"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request - chain is required",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Default trading wallet not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/trading/wallets/{wallet_id}/default": {
      "put": {
        "tags": [
          "Trading Wallets"
        ],
        "summary": "Set Default Trading Wallet",
        "description": "Sets a specific trading wallet as the user's default wallet.\nPlans Included = Basic, Whale, ApiBasic, Builder, Architect, Enterprise Cost per request = 2 credits.\n",
        "operationId": "setDefaultTradingWallet",
        "parameters": [
          {
            "name": "wallet_id",
            "in": "path",
            "description": "Trading wallet ID.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "chain",
            "in": "query",
            "description": "Blockchain chain filter.",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Wallet set as default",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "ok"
                    },
                    "data": {
                      "$ref": "#/paths/~1api~1trading~1wallets/post/responses/200/content/application~1json/schema/properties/data"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request - wallet_id is required",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/trading/wallets/{wallet_id}/name": {
      "put": {
        "tags": [
          "Trading Wallets"
        ],
        "summary": "Rename Trading Wallet",
        "description": "Updates the display name of a trading wallet.\nPlans Included = Basic, Whale, ApiBasic, Builder, Architect, Enterprise Cost per request = 2 credits.\n",
        "operationId": "updateTradingWalletName",
        "parameters": [
          {
            "name": "wallet_id",
            "in": "path",
            "description": "Trading wallet ID.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "chain",
            "in": "query",
            "description": "Blockchain chain filter.",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "new_name": {
                    "type": "string",
                    "description": "New wallet name (1-100 characters).",
                    "minLength": 1,
                    "maxLength": 100,
                    "example": "My Trading Wallet"
                  }
                },
                "required": [
                  "new_name"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Wallet renamed",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "ok"
                    },
                    "data": {
                      "$ref": "#/paths/~1api~1trading~1wallets/post/responses/200/content/application~1json/schema/properties/data"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request - invalid wallet_id or name",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/trading/solana/v2/quote": {
      "get": {
        "tags": [
          "Solana Trading"
        ],
        "summary": "Get Solana Swap Quote (v2)",
        "description": "Fetches a quote for buying or selling tokens on Solana. For buy: swaps the chosen collateral (SOL or USDC) for the specified token. For sell: swaps the specified token for the chosen collateral (SOL or USDC).\nPlans Included = Builder, Architect, Enterprise Cost per request = 5 credits.\n",
        "operationId": "getSolanaQuoteV2",
        "parameters": [
          {
            "name": "type",
            "in": "query",
            "description": "Trade type.",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "buy",
                "sell"
              ]
            },
            "example": "buy"
          },
          {
            "name": "mint",
            "in": "query",
            "description": "Token mint address to buy or sell.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
          },
          {
            "name": "collateral",
            "in": "query",
            "description": "Trading collateral asset. \"sol\" (default) trades against WSOL; \"usdc\" trades against the canonical Solana USDC mint (EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v). Determines the decimals used for the amount field.\n",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "usdc"
              ],
              "default": "sol"
            },
            "example": "sol"
          },
          {
            "name": "amount",
            "in": "query",
            "description": "Human-readable amount in the chosen collateral on buy (1.5 SOL or 1.5 USDC), or in token units on sell. Converted server-side to collateral base units (lamports for SOL, micro-USDC for USDC).\n",
            "required": false,
            "schema": {
              "type": "number"
            },
            "example": 1.5
          },
          {
            "name": "amount_raw",
            "in": "query",
            "description": "Raw amount in collateral base units (lamports for SOL, micro-USDC for USDC, or token's smallest unit on sell). Overrides amount if provided.\n",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "1500000000"
          }
        ],
        "responses": {
          "200": {
            "description": "Quote retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request parameters",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/trading/base/v2/quote": {
      "get": {
        "tags": [
          "Base Trading"
        ],
        "summary": "Get Base Chain Swap Quote",
        "description": "Fetches a quote for buying or selling tokens on Base chain. Amount is human-readable. Collateral can be \"usdc\" (default) or \"eth\".\nPlans Included = Builder, Architect, Enterprise Cost per request = 5 credits.\n",
        "operationId": "getBaseQuote",
        "parameters": [
          {
            "name": "address",
            "in": "query",
            "description": "Token address (EVM format).",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "0x0b3e328455c4059EEb9e3f84b5543F74E24e7E1b"
          },
          {
            "name": "amount",
            "in": "query",
            "description": "Human-readable amount.",
            "required": false,
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "amount_raw",
            "in": "query",
            "description": "Raw unit amount (overrides amount).",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "type",
            "in": "query",
            "description": "Trade type.",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "buy",
                "sell"
              ]
            },
            "example": "buy"
          },
          {
            "name": "collateral",
            "in": "query",
            "description": "Collateral token used as the payment/receive token.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "usdc",
                "eth"
              ],
              "default": "eth"
            },
            "example": "eth"
          }
        ],
        "responses": {
          "200": {
            "description": "Quote retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request parameters",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/trading/base/v2/swap": {
      "post": {
        "tags": [
          "Base Trading"
        ],
        "summary": "Execute Base Chain Swap",
        "description": "Executes a token swap on Base chain. Amount is human-readable. Collateral determines which token is used as payment (buy) or received (sell). Slippage is in basis points (50 = 0.5%).\nRequires both X-API-KEY and Authorization Bearer token.\nPlans Included = Builder, Architect, Enterprise Cost per request = 1 credit.\n",
        "operationId": "executeBaseSwap",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "description": "Bearer token for user authentication.",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "mint": {
                    "type": "string",
                    "description": "Token address (EVM format).",
                    "example": "0x0b3e328455c4059EEb9e3f84b5543F74E24e7E1b"
                  },
                  "type": {
                    "type": "string",
                    "enum": [
                      "buy",
                      "sell"
                    ],
                    "description": "Trade direction.",
                    "example": "buy"
                  },
                  "amount": {
                    "type": "number",
                    "description": "Human-readable amount. Provide either amount or amount_raw, not both.",
                    "example": 1
                  },
                  "amount_raw": {
                    "type": "string",
                    "description": "Raw amount in smallest unit. Overrides amount."
                  },
                  "slippage": {
                    "type": "integer",
                    "description": "Slippage in basis points (50 = 0.5%). Default 50.",
                    "default": 50,
                    "example": 50
                  },
                  "collateral": {
                    "type": "string",
                    "enum": [
                      "usdc",
                      "eth"
                    ],
                    "description": "Collateral token. Default eth.",
                    "default": "eth",
                    "example": "eth"
                  },
                  "trading_wallet": {
                    "type": "string",
                    "description": "EVM trading wallet address to use for the swap.",
                    "example": "0x1234567890abcdef1234567890abcdef12345678"
                  }
                },
                "required": [
                  "mint",
                  "type"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Swap executed successfully",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "ok"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "inputAmount": {
                          "type": "string",
                          "description": "Human-readable input amount."
                        },
                        "outputAmount": {
                          "type": "string",
                          "description": "Human-readable output amount."
                        },
                        "txHash": {
                          "type": "string",
                          "description": "Transaction hash on Base."
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid swap request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "tags": [
    {
      "name": "Feed",
      "x-page-icon": "rss",
      "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."
    },
    {
      "name": "Web Socket",
      "x-page-title": "WebSocket",
      "x-page-icon": "bolt",
      "description": "Real-time stream of the same transactions as the feed, filtered by wallet, list, chain or transaction type."
    },
    {
      "name": "Wallet",
      "x-page-title": "Wallet PnL & Stats",
      "x-page-icon": "chart-line",
      "description": "Per-wallet analytics — token and NFT PnL, trading and enhanced stats, portfolio, balances, token flows and related wallets."
    },
    {
      "name": "Tags",
      "x-page-icon": "tags",
      "description": "Wallet labels such as high win rate, gem finder, sniper or MEV, and the wallets that carry a given tag."
    },
    {
      "name": "Token",
      "x-page-icon": "coins",
      "description": "Token metadata, prices, market stats, liquidity, safety checklist and trending tokens."
    },
    {
      "name": "Chains",
      "x-page-icon": "link",
      "description": "Supported blockchain networks — the authoritative live list used to validate the `chains` query parameter across the API and WebSocket subscribe commands."
    },
    {
      "name": "Tracking",
      "x-page-title": "Wallet Tracking",
      "x-page-icon": "binoculars",
      "description": "Manage the wallets and lists that drive your feed and alerts."
    },
    {
      "name": "Wallet Management",
      "x-page-title": "Tracked Wallets",
      "x-parent": "Tracking",
      "description": "Add, update and remove tracked wallets and their alert filters."
    },
    {
      "name": "Lists",
      "x-parent": "Tracking",
      "description": "Create, update, delete and follow wallet lists."
    },
    {
      "name": "Trading",
      "x-page-icon": "arrow-right-arrow-left",
      "description": "Trade from Cielo trading wallets. Requires a paid plan and trading via API enabled in your account settings at app.cielo.finance."
    },
    {
      "name": "Trading Wallets",
      "x-parent": "Trading",
      "description": "List, create and rename trading wallets and pick the default one."
    },
    {
      "name": "Solana Trading",
      "x-parent": "Trading",
      "description": "Swap quotes on Solana."
    },
    {
      "name": "Base Trading",
      "x-parent": "Trading",
      "description": "Swap quotes and execution on Base."
    }
  ],
  "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.",
            "example": "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.",
            "example": "error message"
          }
        },
        "required": [
          "status",
          "message"
        ]
      },
      "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.",
                    "example": 10
                  },
                  "has_next_page": {
                    "type": "boolean",
                    "description": "A boolean flag indicating if there is a subsequent page available after the current page.",
                    "example": true
                  },
                  "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"
        ]
      },
      "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.",
                "example": "6sdb5o3XWM27RSjcYqoVZ88ruuPzHTfqFQEq26nN6eVq"
              },
              "realized_pnl_usd": {
                "type": "number",
                "format": "float64",
                "description": "The total PnL in usd for the specified wallet.",
                "example": 10000
              },
              "realized_roi_percentage": {
                "type": "number",
                "format": "float64",
                "description": "The total ROI percentage for the specified wallet.",
                "example": 52.2
              },
              "tokens_traded": {
                "type": "integer",
                "description": "The total number of tokens traded for the specified wallet.",
                "example": 25
              },
              "unrealized_pnl_usd": {
                "type": "number",
                "format": "float64",
                "description": "The total unrealized PnL in usd for the specified wallet.",
                "example": 5000
              },
              "unrealized_roi_percentage": {
                "type": "number",
                "format": "float64",
                "description": "The total unrealized ROI percentage for the specified wallet.",
                "example": 75.2
              },
              "winrate": {
                "type": "number",
                "format": "float64",
                "description": "The winrate percentage for the specified wallet.",
                "example": 53.5
              },
              "average_holding_time": {
                "type": "integer",
                "format": "float64",
                "description": "The average holding time for the specified wallet in hours.",
                "example": 5,
                "deprecated": true
              },
              "average_holding_time_seconds": {
                "type": "integer",
                "description": "The average holding time for the specified wallet in seconds.",
                "example": 3600
              },
              "median_holding_time_seconds": {
                "type": "integer",
                "description": "The median holding time for the specified wallet in seconds.",
                "example": 3600
              },
              "combined_pnl_usd": {
                "type": "number",
                "format": "float64",
                "description": "The combined PnL in usd for the specified wallet.",
                "example": 15000
              },
              "combined_roi_percentage": {
                "type": "number",
                "format": "float64",
                "description": "The combined ROI percentage for the specified wallet.",
                "example": 127.4
              },
              "total_buy_usd": {
                "type": "number",
                "format": "float64",
                "description": "The total buy amount in usd for the specified wallet.",
                "example": 10000
              },
              "total_sell_usd": {
                "type": "number",
                "format": "float64",
                "description": "The total sell amount in usd for the specified wallet.",
                "example": 15000
              }
            }
          },
          "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"
        ]
      },
      "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"
        ]
      },
      "TagModel": {
        "type": "object",
        "properties": {
          "key": {
            "$ref": "#/components/schemas/TagTypes",
            "description": "A unique identifier for the tag.",
            "example": "nft_trader"
          },
          "tag": {
            "type": "string",
            "description": "The tag label or name.",
            "example": "NFT Trader"
          },
          "description": {
            "type": "string",
            "description": "A description of what the tag represents.",
            "example": "More than 50 ETH volume trading NFTs"
          }
        },
        "required": [
          "key",
          "tag",
          "description"
        ]
      },
      "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"
        ]
      },
      "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.",
                  "example": "0x0f9d76acdbc4417b026f876be1e2042e45f3bcd2"
                },
                "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"
        ]
      },
      "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.",
                      "example": "0x0f9d76acdbc4417b026f876be1e2042e45f3bcd2"
                    },
                    "wallet_type": {
                      "type": "string",
                      "enum": [
                        "evm",
                        "solana"
                      ],
                      "description": "The wallet type for the wallet returned.",
                      "example": "evm"
                    }
                  }
                }
              },
              "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"
        ]
      },
      "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.",
                      "example": "0x0f9d76acdbc4417b026f876be1e2042e45f3bcd2"
                    },
                    "inflow_usd": {
                      "type": "integer",
                      "description": "The total inflow in usd for the specified wallet.",
                      "example": 10000
                    },
                    "outflow_usd": {
                      "type": "integer",
                      "description": "The total outflow in usd for the specified wallet.",
                      "example": 15000
                    },
                    "total_usd": {
                      "type": "integer",
                      "description": "The total inflow and outflow in usd for the specified wallet.",
                      "example": 25000
                    },
                    "count": {
                      "type": "integer",
                      "description": "The total number of transactions for the specified wallet.",
                      "example": 2
                    },
                    "label": {
                      "type": "string",
                      "description": "The label for the related wallet.",
                      "example": "Wallet Name"
                    }
                  }
                }
              }
            }
          },
          "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"
        ]
      },
      "TokenBalanceResponse": {
        "type": "object",
        "description": "Response containing token balance information",
        "properties": {
          "chain": {
            "type": "string",
            "description": "The chain of the token.",
            "example": "ethereum"
          },
          "token_address": {
            "type": "string",
            "description": "The token address.",
            "example": "0x6B175474E89094C44Da98b954EedeAC495271d0F"
          },
          "token_name": {
            "type": "string",
            "description": "The token name.",
            "example": "Dai Stablecoin"
          },
          "token_symbol": {
            "type": "string",
            "description": "The token symbol.",
            "example": "DAI"
          },
          "token_price_usd": {
            "type": "number",
            "description": "The token price in USD.",
            "example": 0.9999
          },
          "balance": {
            "type": "number",
            "description": "The token balance.",
            "example": 12609.138159
          },
          "total_usd_value": {
            "type": "number",
            "description": "The total USD value.",
            "example": 12607.8772451841
          },
          "decimals": {
            "type": "integer",
            "description": "The number of decimals for the token.",
            "example": 18
          }
        },
        "required": [
          "chain",
          "token_address",
          "token_name",
          "token_symbol",
          "token_price_usd",
          "balance",
          "total_usd_value",
          "decimals"
        ]
      },
      "WalletTypes": {
        "type": "object",
        "description": "Enumerates the different types of wallets.",
        "enum": [
          "unknown",
          "evm",
          "solana",
          "dydx",
          "bitcoin"
        ]
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "TrackedWallet": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "description": "The unique identifier for the tracked wallet.",
            "example": 1
          },
          "wallet": {
            "type": "string",
            "description": "The wallet address for which the related wallets are provided.",
            "example": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2"
          },
          "label": {
            "type": "string",
            "description": "The label for the related wallet.",
            "example": "Wallet Name"
          },
          "type": {
            "$ref": "#/components/schemas/WalletTypes"
          },
          "list_id": {
            "type": "number",
            "description": "The list id for the tracked wallet.",
            "example": 1
          },
          "list": {
            "$ref": "#/components/schemas/WalletsList"
          }
        },
        "required": [
          "id",
          "wallet",
          "label",
          "type"
        ]
      },
      "TrackedWalletsPaging": {
        "type": "object",
        "properties": {
          "total_rows_in_page": {
            "type": "number",
            "description": "The total number of rows in the current page.",
            "example": 10
          },
          "has_next_page": {
            "type": "boolean",
            "description": "Indicates whether there is a next page of results.",
            "example": true
          },
          "next_object": {
            "type": "number",
            "description": "The index of the next object in the result set.",
            "example": 11
          }
        },
        "required": [
          "total_rows_in_page",
          "has_next_page",
          "next_object"
        ]
      },
      "ResponseStatus": {
        "type": "string",
        "enum": [
          "ok",
          "error",
          "pending"
        ]
      },
      "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",
            "example": "ok"
          },
          "data": {
            "type": "array",
            "description": "Array of chain identifiers as used in `chains=` query parameters.",
            "items": {
              "type": "string"
            },
            "example": [
              "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"
            ]
          }
        },
        "required": [
          "status",
          "data"
        ]
      },
      "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"
        ]
      },
      "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.",
            "example": 3600
          },
          "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\")",
            "example": "pump-fun"
          },
          "platform_ui": {
            "type": "string",
            "description": "Human-readable platform name (e.g., \"Pump.fun\", \"Boop\", \"Solana\")",
            "example": "Pump.fun"
          },
          "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.",
            "example": 120
          },
          "held_by": {
            "type": "string",
            "description": "Wallet address that holds this token. Only present when using multi_bundle_id parameter.",
            "example": "0x0f9d76acdbc4417b026f876be1e2042e45f3bcd2"
          },
          "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.",
            "example": {
              "0x0f9d76acdbc4417b026f876be1e2042e45f3bcd2": "Whale 1"
            }
          }
        }
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "Paging": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer",
            "minimum": 1
          },
          "total_rows_in_page": {
            "type": "integer",
            "minimum": 0,
            "example": 10
          },
          "has_next_page": {
            "type": "boolean",
            "example": true
          }
        },
        "required": [
          "page",
          "total_rows_in_page",
          "has_next_page"
        ]
      },
      "TokenFlowV2Item": {
        "type": "object",
        "properties": {
          "address": {
            "type": "string",
            "description": "Token contract address.",
            "example": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
          },
          "symbol": {
            "type": "string",
            "description": "Token symbol.",
            "example": "USDC"
          },
          "name": {
            "type": "string",
            "description": "Token name.",
            "example": "USD Coin"
          },
          "chain": {
            "type": "string",
            "description": "Blockchain chain.",
            "example": "solana"
          },
          "net_flow_usd": {
            "type": "integer",
            "description": "Net flow in USD (buy - sell).",
            "example": 1500
          },
          "net_flow_usd_width": {
            "type": "integer",
            "description": "Relative width for net flow visualization.",
            "example": 75
          },
          "net_flow_amount": {
            "type": "integer",
            "description": "Net flow token amount.",
            "example": 1500
          },
          "buy_usd": {
            "type": "integer",
            "description": "Total buy amount in USD.",
            "example": 3000
          },
          "buy_usd_width": {
            "type": "integer",
            "description": "Relative width for buy visualization.",
            "example": 80
          },
          "buy_amount": {
            "type": "integer",
            "description": "Total buy token amount.",
            "example": 3000
          },
          "sell_usd": {
            "type": "integer",
            "description": "Total sell amount in USD.",
            "example": 1500
          },
          "sell_usd_width": {
            "type": "integer",
            "description": "Relative width for sell visualization.",
            "example": 40
          },
          "sell_amount": {
            "type": "integer",
            "description": "Total sell token amount.",
            "example": 1500
          },
          "avg_buy_usd": {
            "type": "integer",
            "description": "Average buy price in USD.",
            "example": 1
          },
          "avg_sell_usd": {
            "type": "integer",
            "description": "Average sell price in USD.",
            "example": 1
          },
          "wallets_num": {
            "type": "integer",
            "description": "Number of distinct wallets.",
            "example": 5
          },
          "trades_num": {
            "type": "integer",
            "description": "Number of trades.",
            "example": 12
          },
          "chart_link": {
            "type": "string",
            "description": "Link to chart for this token.",
            "example": ""
          },
          "platform": {
            "type": "string",
            "description": "Token launch platform code (Solana tokens only).",
            "example": "pump-fun"
          },
          "platform_uri": {
            "type": "string",
            "description": "URL to the token on its launch platform (Solana tokens only).",
            "example": "https://pump.fun/coin/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
          }
        }
      },
      "NewTokenFlowItem": {
        "type": "object",
        "properties": {
          "chain": {
            "type": "string",
            "description": "Blockchain chain.",
            "example": "solana"
          },
          "address": {
            "type": "string",
            "description": "Token contract address.",
            "example": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
          },
          "symbol": {
            "type": "string",
            "description": "Token symbol.",
            "example": "USDC"
          },
          "name": {
            "type": "string",
            "description": "Token name.",
            "example": "USD Coin"
          },
          "net_flow_usd": {
            "type": "integer",
            "description": "Net flow in USD (buy - sell).",
            "example": 1500
          },
          "net_flow_usd_width": {
            "type": "integer",
            "description": "Relative width for net flow visualization.",
            "example": 75
          },
          "net_flow_amount": {
            "type": "integer",
            "description": "Net flow token amount.",
            "example": 1500
          },
          "buy_usd": {
            "type": "integer",
            "description": "Total buy amount in USD.",
            "example": 3000
          },
          "buy_usd_width": {
            "type": "integer",
            "description": "Relative width for buy visualization.",
            "example": 80
          },
          "buy_amount": {
            "type": "integer",
            "description": "Total buy token amount.",
            "example": 3000
          },
          "sell_usd": {
            "type": "integer",
            "description": "Total sell amount in USD.",
            "example": 1500
          },
          "sell_usd_width": {
            "type": "integer",
            "description": "Relative width for sell visualization.",
            "example": 40
          },
          "sell_amount": {
            "type": "integer",
            "description": "Total sell token amount.",
            "example": 1500
          },
          "avg_buy_usd": {
            "type": "integer",
            "description": "Average buy price in USD.",
            "example": 1
          },
          "avg_sell_usd": {
            "type": "integer",
            "description": "Average sell price in USD.",
            "example": 1
          },
          "wallets_num": {
            "type": "integer",
            "description": "Number of distinct wallets.",
            "example": 5
          },
          "trades_num": {
            "type": "integer",
            "description": "Number of trades.",
            "example": 12
          },
          "timestamp": {
            "type": "integer",
            "description": "Token creation timestamp (Unix epoch).",
            "example": 1678901234
          },
          "chart_link": {
            "type": "string",
            "description": "Link to chart for this token.",
            "example": ""
          },
          "platform": {
            "type": "string",
            "description": "Token launch platform code (Solana tokens only).",
            "example": "pump-fun"
          },
          "platform_uri": {
            "type": "string",
            "description": "URL to the token on its launch platform (Solana tokens only).",
            "example": "https://pump.fun/coin/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
          }
        }
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "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": {
              "pro_traders": {
                "type": "integer",
                "minimum": 0,
                "nullable": true,
                "description": "Unsigned 64-bit count (0 to 18446744073709551615). Observed distinct eligible makers with confirmed token-specific terminal use; null when unavailable."
              },
              "traders": {
                "type": "integer",
                "minimum": 0,
                "nullable": true,
                "description": "Unsigned 64-bit count (0 to 18446744073709551615). Distinct eligible makers from the same population and time window as pro_traders."
              },
              "pro_traders_percentage": {
                "type": "number",
                "minimum": 0,
                "maximum": 100,
                "nullable": true,
                "description": "100 × pro_traders divided by traders (0–100); zero for an available empty population, null when unavailable."
              },
              "coverage_complete": {
                "type": "boolean",
                "nullable": true,
                "description": "False for partial observed history or rolling warmup; null when unavailable. Lifetime statistics and trending window statistics have separate coverage."
              },
              "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"
        ]
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "TrendingTokensResponse": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "example": "ok"
          },
          "message": {
            "type": "string",
            "example": "success"
          },
          "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": {
          "pro_traders": {
            "type": "integer",
            "minimum": 0,
            "nullable": true,
            "description": "Unsigned 64-bit count (0 to 18446744073709551615). Observed distinct eligible makers with confirmed token-specific terminal use; null when unavailable."
          },
          "traders": {
            "type": "integer",
            "minimum": 0,
            "nullable": true,
            "description": "Unsigned 64-bit count (0 to 18446744073709551615). Distinct eligible makers from the same population and time window as pro_traders."
          },
          "pro_traders_percentage": {
            "type": "number",
            "minimum": 0,
            "maximum": 100,
            "nullable": true,
            "description": "100 × pro_traders divided by traders (0–100); zero for an available empty population, null when unavailable."
          },
          "coverage_complete": {
            "type": "boolean",
            "nullable": true,
            "description": "False for partial observed history or rolling warmup; null when unavailable. Lifetime statistics and trending window statistics have separate coverage."
          },
          "token_address": {
            "type": "string",
            "description": "The token contract address.",
            "example": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN"
          },
          "token_symbol": {
            "type": "string",
            "description": "The token symbol.",
            "example": "PUMP"
          },
          "token_name": {
            "type": "string",
            "description": "The token name.",
            "example": "Pump.fun"
          },
          "chain": {
            "type": "string",
            "description": "The blockchain network.",
            "example": "solana"
          },
          "platform": {
            "type": "string",
            "description": "The platform code.",
            "example": "pump-fun"
          },
          "platform_ui": {
            "type": "string",
            "description": "Human-readable platform name.",
            "example": "Pump.fun"
          },
          "platform_uri": {
            "type": "string",
            "description": "Platform URI."
          },
          "market_cap": {
            "type": "number",
            "description": "Market cap in USD.",
            "example": 1000000
          },
          "liquidity": {
            "type": "number",
            "description": "Total liquidity in USD.",
            "example": 500000
          },
          "volume_24h": {
            "type": "number",
            "description": "24-hour trading volume in USD.",
            "example": 250000
          },
          "unique_wallets": {
            "type": "integer",
            "description": "Number of unique wallets that traded this token in the given interval.",
            "example": 150
          },
          "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."
          }
        }
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "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."
          }
        },
        "example": {
          "tx_types": [
            "transfer",
            "swap"
          ],
          "chains": [
            "chain1",
            "chain2"
          ],
          "tokens": [
            "token1",
            "token2"
          ],
          "min_usd_value": 100
        }
      },
      "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"
        ]
      },
      "WebsocketErrorEvent": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "error"
            ]
          },
          "data": {
            "type": "string",
            "description": "The error message."
          }
        },
        "required": [
          "type",
          "data"
        ],
        "example": {
          "type": "error",
          "data": "invalid command"
        }
      },
      "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.",
            "example": "0xa4c8d9e4ec5f2831701a81389465498b83f9457d"
          },
          "wallet_label": {
            "type": "string",
            "description": "A shortened, more readable version of the wallet address.",
            "example": "0xa4c8...f9457d"
          },
          "tx_hash": {
            "type": "string",
            "description": "The unique hash identifier of the transaction.",
            "example": "0xb23dc807e8063feaefe20644f85d13a7238a8b01b9fd167135ef664146692f99"
          },
          "tx_type": {
            "type": "string",
            "description": "The type of transaction.",
            "example": "bridge"
          },
          "chain": {
            "type": "string",
            "description": "The blockchain on which the transaction occurred, like 'ethereum'.",
            "example": "ethereum"
          },
          "index": {
            "type": "integer",
            "description": "A numeric index or identifier for the transaction.",
            "example": 7
          },
          "timestamp": {
            "type": "integer",
            "description": "The timestamp when the transaction occurred.",
            "example": 1702899899
          },
          "block": {
            "type": "integer",
            "description": "The block number on the blockchain in which the transaction is included.",
            "example": 18812661
          },
          "from": {
            "type": "string",
            "description": "The originating wallet address of the transaction.",
            "example": "0xecc19e177d24551aa7ed6bc6fe566eca726cc8a9"
          },
          "to": {
            "type": "string",
            "description": "The destination wallet address of the transaction.",
            "example": "0xbf3b71decbcefabb3210b9d8f18ec22e0556f5f0"
          },
          "from_label": {
            "type": "string",
            "description": "A shortened, more readable version of the originating wallet address.",
            "example": "0xecc1...cc8a9"
          },
          "to_label": {
            "type": "string",
            "description": "A shortened, more readable version of the destination wallet address.",
            "example": "0xbf3b...6f5f0"
          },
          "token_address": {
            "type": "string",
            "description": "The address of the token involved in the transaction.",
            "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
          },
          "token_name": {
            "type": "string",
            "description": "The name of the token involved in the transaction.",
            "example": "Wrapped Ether"
          },
          "token_symbol": {
            "type": "string",
            "description": "The symbol of the token involved in the transaction.",
            "example": "WETH"
          },
          "token_icon_link": {
            "type": "string",
            "description": "A link to the icon of the token involved in the transaction.",
            "example": "https://logos.uniwhales.io/ethereum/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2.jpg"
          },
          "amount": {
            "type": "number",
            "format": "double",
            "description": "The amount of the token involved in the transaction.",
            "example": 0.09956219862680922
          },
          "amount_usd": {
            "type": "number",
            "format": "double",
            "description": "The equivalent amount in USD of the tokens involved in the transaction.",
            "example": 212.00276764599622
          },
          "from_chain": {
            "type": "string",
            "description": "The originating chain of the transaction, in cases of cross-chain activities.",
            "example": "Arbitrum"
          },
          "to_chain": {
            "type": "string",
            "description": "The destination chain of the transaction, in cases of cross-chain activities.",
            "example": "Ethereum"
          },
          "platform": {
            "type": "string",
            "description": "The platform or service used for the transaction.",
            "example": "Stargate"
          },
          "price": {
            "type": "number",
            "format": "double",
            "description": "The price of the token at the time of the transaction.",
            "example": 2129.35
          },
          "type": {
            "type": "string",
            "description": "Specifies the nature of the transaction, like 'withdraw', 'deposit', etc.",
            "example": "withdraw"
          }
        },
        "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"
        ]
      },
      "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.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "wallet_label": {
            "type": "string",
            "description": "A more readable, shortened version of the wallet address.",
            "example": "0xa4c8...f9457d"
          },
          "tx_hash": {
            "type": "string",
            "description": "The unique identifier of the transaction, represented as a hash.",
            "example": "0xe0f84917036e7e2ebb2f8d73199547bde30d4d2918c67904a4bb200dc5bad215"
          },
          "tx_type": {
            "type": "string",
            "description": "Specifies the type of DeFi transaction, such as lending, borrowing, etc.",
            "example": "lending"
          },
          "chain": {
            "type": "string",
            "description": "Indicates the blockchain network on which the transaction occurred.",
            "example": "base"
          },
          "index": {
            "type": "integer",
            "description": "A sequential index or identifier for the transaction within a particular dataset or list.",
            "example": 10
          },
          "timestamp": {
            "type": "integer",
            "description": "The timestamp marking when the transaction was executed.",
            "example": 1702899395
          },
          "block": {
            "type": "integer",
            "description": "The block number in the blockchain where this transaction is recorded.",
            "example": 113650309
          },
          "from": {
            "type": "string",
            "description": "The originating wallet address for the transaction.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "from_label": {
            "type": "string",
            "description": "A readable, abbreviated form of the 'from' wallet address.",
            "example": "0xa4c8...f9457d"
          },
          "action": {
            "type": "string",
            "description": "Describes the action taken in the transaction, such as 'Repaid' in a lending scenario.",
            "example": "Repaid"
          },
          "address": {
            "type": "string",
            "description": "The smart contract address involved in the transaction.",
            "example": "0x4200000000000000000000000000000000000006"
          },
          "amount": {
            "type": "number",
            "format": "double",
            "description": "The amount of the asset involved in the transaction.",
            "example": 50.007801987424834
          },
          "amount_usd": {
            "type": "number",
            "format": "double",
            "description": "The equivalent value of the transaction amount in USD.",
            "example": 106652.63945462069
          },
          "dex": {
            "type": "string",
            "description": "The decentralized exchange or platform where the transaction occurred, such as AaveV2.",
            "example": "AaveV2"
          },
          "health_factor": {
            "type": "number",
            "format": "double",
            "description": "A metric specific to lending platforms, indicating the health of the loan or position.",
            "example": 1000
          },
          "name": {
            "type": "string",
            "description": "The name of the asset involved in the transaction.",
            "example": "Wrapped Ether"
          },
          "platform": {
            "type": "string",
            "description": "The DeFi platform associated with the transaction, like AaveV3.",
            "example": "AaveV3"
          },
          "price_usd": {
            "type": "number",
            "format": "double",
            "description": "The price of the asset in USD at the time of the transaction.",
            "example": 2132.72
          },
          "symbol": {
            "type": "string",
            "description": "The symbol of the asset involved in the transaction.",
            "example": "WETH"
          },
          "token_icon_link": {
            "type": "string",
            "description": "A URL link to the icon image of the token involved in the transaction.",
            "example": "https://logos.uniwhales.io/ethereum/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2.jpg"
          }
        },
        "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"
        ]
      },
      "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.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "wallet_label": {
            "type": "string",
            "description": "A human-readable label or name associated with the wallet, such as a ENS name.",
            "example": "vitalik.eth"
          },
          "tx_hash": {
            "type": "string",
            "description": "The unique transaction hash identifying this specific LP transaction.",
            "example": "0xe0f84917036e7e2ebb2f8d73199547bde30d4d2918c67904a4bb200dc5bad215"
          },
          "tx_type": {
            "type": "string",
            "description": "Indicates the type of transaction, in this case, liquidity pool (LP) related.",
            "example": "lp"
          },
          "chain": {
            "type": "string",
            "description": "The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place.",
            "example": "optimism"
          },
          "index": {
            "type": "integer",
            "description": "A numerical index or identifier for the transaction.",
            "example": 10
          },
          "timestamp": {
            "type": "integer",
            "description": "The timestamp marking when the transaction was executed.",
            "example": 1702899395
          },
          "block": {
            "type": "integer",
            "description": "The block number on the blockchain where this transaction is recorded.",
            "example": 113650309
          },
          "dex": {
            "type": "string",
            "description": "The name of the decentralized exchange where the LP transaction occurred.",
            "example": "Odos"
          },
          "from": {
            "type": "string",
            "description": "The originating wallet address for the transaction.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "type": {
            "type": "string",
            "description": "Specifies the nature of the LP transaction, such as 'add' or 'remove'.",
            "example": "add"
          },
          "token0_address": {
            "type": "string",
            "description": "The address of the first token involved in the LP transaction.",
            "example": "0x7f5c764cbc14f9669b88837ca1490cca17c31607"
          },
          "token0_amount": {
            "type": "number",
            "format": "double",
            "description": "The amount of the first token involved in the transaction.",
            "example": 25
          },
          "token0_amount_usd": {
            "type": "number",
            "format": "double",
            "description": "The USD value of the first token amount at the time of the transaction.",
            "example": 25
          },
          "token0_name": {
            "type": "string",
            "description": "The name of the first token involved in the transaction.",
            "example": "USD Coin"
          },
          "token0_price_usd": {
            "type": "number",
            "format": "double",
            "description": "The price of the first token in USD.",
            "example": 1
          },
          "token0_symbol": {
            "type": "string",
            "description": "The symbol of the first token involved in the transaction.",
            "example": "USDC"
          },
          "token0_icon_link": {
            "type": "string",
            "description": "A link to the icon of the token involved in the transaction.",
            "example": "https://logos.uniwhales.io/ethereum/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2.jpg"
          },
          "token1_address": {
            "type": "string",
            "description": "The address of the second token involved in the LP transaction.",
            "example": "0x0000000000000000000000000000000000000000"
          },
          "token1_amount": {
            "type": "number",
            "format": "double",
            "description": "The amount of the second token involved in the transaction.",
            "example": 25
          },
          "token1_amount_usd": {
            "type": "number",
            "format": "double",
            "description": "The USD value of the second token amount at the time of the transaction.",
            "example": 25
          },
          "token1_name": {
            "type": "string",
            "description": "The name of the second token involved in the transaction.",
            "example": "USD Coin"
          },
          "token1_price_usd": {
            "type": "number",
            "format": "double",
            "description": "The price of the second token in USD.",
            "example": 1
          },
          "token1_symbol": {
            "type": "string",
            "description": "The symbol of the second token involved in the transaction.",
            "example": "USDC"
          },
          "token1_icon_link": {
            "type": "string",
            "description": "A link to the icon of the token involved in the transaction.",
            "example": "https://logos.uniwhales.io/ethereum/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2.jpg"
          },
          "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.",
            "example": 0
          },
          "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.",
            "example": 0
          }
        },
        "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"
        ]
      },
      "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.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "wallet_label": {
            "type": "string",
            "description": "A more readable label or identifier for the wallet address.",
            "example": "0xa4c8...f9457d"
          },
          "tx_hash": {
            "type": "string",
            "description": "The unique hash identifier of the NFT lending transaction.",
            "example": "0xe0f84917036e7e2ebb2f8d73199547bde30d4d2918c67904a4bb200dc5bad215"
          },
          "tx_type": {
            "type": "string",
            "description": "Specifies the type of transaction, in this case, NFT lending.",
            "example": "nft_lending"
          },
          "chain": {
            "type": "string",
            "description": "The blockchain network on which the transaction was conducted.",
            "example": "ethereum"
          },
          "index": {
            "type": "integer",
            "description": "A numerical index or identifier for the transaction.",
            "example": 10
          },
          "timestamp": {
            "type": "integer",
            "description": "The timestamp marking when the transaction was executed.",
            "example": 1702899395
          },
          "block": {
            "type": "integer",
            "description": "The block number on the blockchain where this transaction is recorded.",
            "example": 113650309
          },
          "from": {
            "type": "string",
            "description": "The originating wallet address of the transaction.",
            "example": "0xebc18d25d8122da21f73a6bcb78971671f21f6ff"
          },
          "to": {
            "type": "string",
            "description": "The destination wallet address of the transaction.",
            "example": "0xcfdbdb8723619bca23765e09d59c8f745366f8ff"
          },
          "from_label": {
            "type": "string",
            "description": "A readable version of the 'from' wallet address.",
            "example": "0xebc18d25d8122da21f73a6bcb78971671f21f6ff"
          },
          "to_label": {
            "type": "string",
            "description": "A readable version of the 'to' wallet address.",
            "example": "0xcfdb...6f8ff"
          },
          "thumbnail": {
            "type": "string",
            "description": "A thumbnail image URL of the NFT involved in the transaction.",
            "example": "https://res.cloudinary.com/alchemyapi/image/upload/thumbnailv2/matic-mainnet/284ed679247466683591389baddcfc9b"
          },
          "image": {
            "type": "string",
            "description": "A full image URL of the NFT.",
            "example": "https://nft-cdn.alchemy.com/matic-mainnet/284ed679247466683591389baddcfc9b"
          },
          "action": {
            "type": "string",
            "description": "Describes the action taken in the NFT lending transaction, such as 'buy', 'lend', etc.",
            "example": "buy"
          },
          "currency_address": {
            "type": "string",
            "description": "The blockchain address of the currency used in the transaction.",
            "example": "0x00000000000000adc04c56bf30ac9d3c0aaf14dc"
          },
          "currency_symbol": {
            "type": "string",
            "description": "The symbol of the currency used in the transaction.",
            "example": "OpenSea"
          },
          "interest": {
            "type": "number",
            "format": "double",
            "description": "The interest rate applied in the NFT lending transaction.",
            "example": 0.0151
          },
          "nft_address": {
            "type": "string",
            "description": "The blockchain address of the NFT involved in the transaction.",
            "example": "0xbe9371326f91345777b04394448c23e2bfeaa826"
          },
          "nft_name": {
            "type": "string",
            "description": "The name of the NFT.",
            "example": "Gemesis"
          },
          "nft_symbol": {
            "type": "string",
            "description": "The symbol of the NFT.",
            "example": "OSP"
          },
          "platform": {
            "type": "string",
            "description": "The platform or service through which the NFT lending transaction was conducted.",
            "example": "Blend"
          },
          "nft_token_id": {
            "type": "string",
            "description": "The unique identifier for the specific NFT within its collection.",
            "example": 32507
          },
          "price": {
            "type": "number",
            "format": "double",
            "description": "The price at which the NFT was lent or transacted.",
            "example": 0.0151
          },
          "price_usd": {
            "type": "number",
            "format": "double",
            "description": "The equivalent USD value of the transaction price.",
            "example": 32.911356
          },
          "terms": {
            "type": "number",
            "format": "double",
            "description": "Specifies the terms of the NFT lending agreement.",
            "example": 0.0151
          },
          "refinance": {
            "type": "boolean",
            "description": "Indicates whether the transaction involved refinancing of the NFT.",
            "example": false
          }
        },
        "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"
        ]
      },
      "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.",
            "example": "0xa4c8d9e4ec5f2831701a81389465498b83f9457d"
          },
          "wallet_label": {
            "type": "string",
            "description": "A more readable label or identifier for the wallet address.",
            "example": "0xa4c8...f9457d"
          },
          "tx_hash": {
            "type": "string",
            "description": "The unique hash identifier of the NFT minting transaction.",
            "example": "0xe0f84917036e7e2ebb2f8d73199547bde30d4d2918c67904a4bb200dc5bad215"
          },
          "tx_type": {
            "type": "string",
            "description": "Specifies the type of transaction, in this case, NFT minting.",
            "example": "nft_mint"
          },
          "chain": {
            "type": "string",
            "description": "The blockchain network on which the minting transaction was conducted.",
            "example": "ethereum"
          },
          "index": {
            "type": "integer",
            "description": "A numerical index or identifier for the transaction.",
            "example": 10
          },
          "timestamp": {
            "type": "integer",
            "description": "The timestamp marking when the transaction was executed.",
            "example": 1702899395
          },
          "block": {
            "type": "integer",
            "description": "The block number on the blockchain where this transaction is recorded.",
            "example": 113650309
          },
          "from": {
            "type": "string",
            "description": "The originating wallet address of the transaction.",
            "example": "0xebc18d25d8122da21f73a6bcb78971671f21f6ff"
          },
          "to": {
            "type": "string",
            "description": "The destination wallet address of the transaction.",
            "example": "0xcfdbdb8723619bca23765e09d59c8f745366f8ff"
          },
          "from_label": {
            "type": "string",
            "description": "A readable version of the 'from' wallet address.",
            "example": "0xebc18d25d8122da21f73a6bcb78971671f21f6ff"
          },
          "to_label": {
            "type": "string",
            "description": "A readable version of the 'to' wallet address.",
            "example": "0xcfdb...6f8ff"
          },
          "thumbnail": {
            "type": "string",
            "description": "A thumbnail image URL of the NFT involved in the transaction.",
            "example": "https://res.cloudinary.com/alchemyapi/image/upload/thumbnailv2/matic-mainnet/284ed679247466683591389baddcfc9b"
          },
          "image": {
            "type": "string",
            "description": "A full image URL of the NFT.",
            "example": "https://nft-cdn.alchemy.com/matic-mainnet/284ed679247466683591389baddcfc9b"
          },
          "amount": {
            "type": "number",
            "format": "double",
            "description": "The number of items of the NFT minted in the transaction.",
            "example": 1
          },
          "contract_address": {
            "type": "string",
            "description": "The blockchain address of the contract under which the NFT is minted.",
            "example": "0xb27bbc8f0092284a880d1616f184d86c1a640fae"
          },
          "contract_type": {
            "type": "string",
            "description": "The type of contract used for the NFT, such as ERC721.",
            "example": "ERC721"
          },
          "fee": {
            "type": "number",
            "format": "double",
            "description": "The transaction fee incurred for minting the NFT.",
            "example": 0.21357696
          },
          "nft_name": {
            "type": "string",
            "description": "The name of the NFT minted.",
            "example": "unknown"
          },
          "nft_symbol": {
            "type": "string",
            "description": "The symbol associated with the NFT.",
            "example": "unknown"
          },
          "nft_token_id": {
            "type": "string",
            "description": "The unique token ID of the minted NFT.",
            "example": 14
          },
          "currency_symbol": {
            "type": "string",
            "description": "The symbol of the currency used in the transaction (e.g., ETH, MATIC).",
            "example": "MATIC"
          },
          "type": {
            "type": "string",
            "description": "Indicates the contract standard of the NFT, such as ERC721.",
            "example": "ERC721"
          },
          "value": {
            "type": "number",
            "format": "double",
            "description": "The value of the transaction. For minting, this is often zero since the NFT is being created.",
            "example": 0
          },
          "value_usd": {
            "type": "number",
            "format": "double",
            "description": "The equivalent USD value of the transaction.",
            "example": 0
          }
        },
        "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.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "wallet_label": {
            "type": "string",
            "description": "A readable label for the wallet address.",
            "example": "0xa4c8...f9457d"
          },
          "tx_hash": {
            "type": "string",
            "description": "The unique hash identifier of the NFT trading transaction.",
            "example": "0xe0f84917036e7e2ebb2f8d73199547bde30d4d2918c67904a4bb200dc5bad215"
          },
          "tx_type": {
            "type": "string",
            "description": "Specifies the type of transaction, in this case, NFT trading.",
            "example": "nft_trade"
          },
          "chain": {
            "type": "string",
            "description": "The blockchain network where the trading transaction occurred.",
            "example": "ethereum"
          },
          "index": {
            "type": "integer",
            "description": "A numerical index or identifier for the transaction.",
            "example": 10
          },
          "timestamp": {
            "type": "integer",
            "description": "The timestamp marking when the transaction was executed.",
            "example": 1702899395
          },
          "block": {
            "type": "integer",
            "description": "The block number on the blockchain where this transaction is recorded.",
            "example": 113650309
          },
          "from": {
            "type": "string",
            "description": "The originating wallet address of the transaction.",
            "example": "0xebc18d25d8122da21f73a6bcb78971671f21f6ff"
          },
          "to": {
            "type": "string",
            "description": "The destination wallet address of the transaction.",
            "example": "0xcfdbdb8723619bca23765e09d59c8f745366f8ff"
          },
          "thumbnail": {
            "type": "string",
            "description": "A thumbnail image URL of the NFT involved in the transaction.",
            "example": "https://res.cloudinary.com/alchemyapi/image/upload/thumbnailv2/matic-mainnet/284ed679247466683591389baddcfc9b"
          },
          "image": {
            "type": "string",
            "description": "A full image URL of the NFT.",
            "example": "https://nft-cdn.alchemy.com/matic-mainnet/284ed679247466683591389baddcfc9b"
          },
          "action": {
            "type": "string",
            "description": "Describes the action taken in the NFT trade, such as 'buy' or 'sell'.",
            "example": "buy"
          },
          "contract": {
            "type": "string",
            "description": "The blockchain contract address associated with the NFT.",
            "example": "0x00000000000000adc04c56bf30ac9d3c0aaf14dc"
          },
          "marketplace": {
            "type": "string",
            "description": "The marketplace where the NFT trade occurred, such as OpenSea.",
            "example": "OpenSea"
          },
          "nft_address": {
            "type": "string",
            "description": "The blockchain address of the NFT involved in the trade.",
            "example": "0xbe9371326f91345777b04394448c23e2bfeaa826"
          },
          "nft_name": {
            "type": "string",
            "description": "The name of the NFT traded.",
            "example": "Gemesis"
          },
          "nft_symbol": {
            "type": "string",
            "description": "The symbol associated with the NFT.",
            "example": "OSP"
          },
          "nft_token_id": {
            "type": "string",
            "description": "The unique token ID of the NFT involved in the trade.",
            "example": 32507
          },
          "price": {
            "type": "number",
            "format": "double",
            "description": "The price at which the NFT was traded.",
            "example": 0.0151
          },
          "price_usd": {
            "type": "number",
            "format": "double",
            "description": "The equivalent USD value of the NFT trade.",
            "example": 32.911356
          },
          "profit": {
            "type": "number",
            "format": "double",
            "description": "The profit earned from the trade. This may be zero in some transactions.",
            "example": 0
          },
          "currency_symbol": {
            "type": "string",
            "description": "The symbol of the currency used in the trade, such as WETH or ETH.",
            "example": "WETH"
          },
          "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.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "wallet_label": {
            "type": "string",
            "description": "A readable label for the wallet address.",
            "example": "0xa4c8...f9457d"
          },
          "tx_hash": {
            "type": "string",
            "description": "The unique hash identifier of the NFT transfer transaction.",
            "example": "0xe0f84917036e7e2ebb2f8d73199547bde30d4d2918c67904a4bb200dc5bad215"
          },
          "tx_type": {
            "type": "string",
            "description": "Specifies the type of transaction, in this case, NFT transfer.",
            "example": "nft_transfer"
          },
          "chain": {
            "type": "string",
            "description": "The blockchain network where the transfer transaction occurred.",
            "example": "ethereum"
          },
          "index": {
            "type": "integer",
            "description": "A numerical index or identifier for the transaction.",
            "example": 10
          },
          "timestamp": {
            "type": "integer",
            "description": "The timestamp marking when the transaction was executed.",
            "example": 1702899395
          },
          "block": {
            "type": "integer",
            "description": "The block number on the blockchain where this transaction is recorded.",
            "example": 113650309
          },
          "from": {
            "type": "string",
            "description": "The originating wallet address of the transaction.",
            "example": "0xebc18d25d8122da21f73a6bcb78971671f21f6ff"
          },
          "to": {
            "type": "string",
            "description": "The destination wallet address of the transaction.",
            "example": "0xcfdbdb8723619bca23765e09d59c8f745366f8ff"
          },
          "from_label": {
            "type": "string",
            "description": "A readable version of the 'from' wallet address.",
            "example": "0xebc18d25d8122da21f73a6bcb78971671f21f6ff"
          },
          "to_label": {
            "type": "string",
            "description": "A readable version of the 'to' wallet address.",
            "example": "0xcfdb...6f8ff"
          },
          "thumbnail": {
            "type": "string",
            "description": "A thumbnail image URL of the NFT involved in the transaction.",
            "example": "https://res.cloudinary.com/alchemyapi/image/upload/thumbnailv2/matic-mainnet/284ed679247466683591389baddcfc9b"
          },
          "image": {
            "type": "string",
            "description": "A full image URL of the NFT.",
            "example": "https://nft-cdn.alchemy.com/matic-mainnet/284ed679247466683591389baddcfc9b"
          },
          "contract_address": {
            "type": "string",
            "description": "The blockchain address of the contract under which the NFT is registered.",
            "example": "0xb27bbc8f0092284a880d1616f184d86c1a640fae"
          },
          "contract_type": {
            "type": "string",
            "description": "The type of contract used for the NFT, such as ERC721.",
            "example": "ERC721"
          },
          "fee": {
            "type": "number",
            "format": "double",
            "description": "The transaction fee incurred for the transfer of the NFT.",
            "example": 0.21357696
          },
          "nft_name": {
            "type": "string",
            "description": "The name of the NFT being transferred.",
            "example": "unknown"
          },
          "nft_symbol": {
            "type": "string",
            "description": "The symbol associated with the NFT.",
            "example": "unknown"
          },
          "nft_token_id": {
            "type": "string",
            "description": "The unique token ID of the NFT involved in the transfer.",
            "example": 3
          },
          "type": {
            "type": "string",
            "description": "Indicates the contract standard of the NFT, such as ERC721.",
            "example": "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"
        ]
      },
      "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.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "wallet_label": {
            "type": "string",
            "description": "A readable label for the wallet address.",
            "example": "0xa4c8...f9457d"
          },
          "tx_hash": {
            "type": "string",
            "description": "The unique hash identifier of the swap transaction.",
            "example": "0xe0f84917036e7e2ebb2f8d73199547bde30d4d2918c67904a4bb200dc5bad215"
          },
          "tx_type": {
            "type": "string",
            "description": "Specifies the type of transaction, in this case, a token swap.",
            "example": "swap"
          },
          "chain": {
            "type": "string",
            "description": "The blockchain network where the swap transaction occurred.",
            "example": "optimism"
          },
          "index": {
            "type": "integer",
            "description": "A numerical index or identifier for the transaction.",
            "example": 10
          },
          "timestamp": {
            "type": "integer",
            "description": "The timestamp marking when the transaction was executed.",
            "example": 1702899395
          },
          "block": {
            "type": "integer",
            "description": "The block number on the blockchain where this transaction is recorded.",
            "example": 113650309
          },
          "dex": {
            "type": "string",
            "description": "The decentralized exchange where the swap transaction took place.",
            "example": "Odos"
          },
          "from": {
            "type": "string",
            "description": "The originating wallet address of the transaction.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "to": {
            "type": "string",
            "description": "The destination wallet address of the transaction (often the same as the 'from' address in swap transactions).",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "token0_address": {
            "type": "string",
            "description": "The address of the first token involved in the swap.",
            "example": "0x7f5c764cbc14f9669b88837ca1490cca17c31607"
          },
          "token0_amount": {
            "type": "number",
            "format": "double",
            "description": "The amount of the first token involved in the swap.",
            "example": 25
          },
          "token0_amount_usd": {
            "type": "number",
            "format": "double",
            "description": "The USD value of the first token amount at the time of the swap.",
            "example": 25
          },
          "token0_name": {
            "type": "string",
            "description": "The name of the first token involved in the swap.",
            "example": "USD Coin"
          },
          "token0_price_usd": {
            "type": "number",
            "format": "double",
            "description": "The price of the first token in USD.",
            "example": 1
          },
          "token0_symbol": {
            "type": "string",
            "description": "The symbol of the first token involved in the swap.",
            "example": "USDC"
          },
          "token0_icon_link": {
            "type": "string",
            "description": "A link to the icon of the token involved in the transaction.",
            "example": "https://logos.uniwhales.io/ethereum/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2.jpg"
          },
          "token1_address": {
            "type": "string",
            "description": "The address of the second token involved in the swap.",
            "example": "0x0000000000000000000000000000000000000000"
          },
          "token1_amount": {
            "type": "number",
            "format": "double",
            "description": "The amount of the second token involved in the swap.",
            "example": 0.011715203954716423
          },
          "token1_amount_usd": {
            "type": "number",
            "format": "double",
            "description": "The USD value of the second token amount at the time of the swap.",
            "example": 25
          },
          "token1_name": {
            "type": "string",
            "description": "The name of the second token involved in the swap.",
            "example": "Ethereum"
          },
          "token1_price_usd": {
            "type": "number",
            "format": "double",
            "description": "The price of the second token in USD.",
            "example": 2133.979066573165
          },
          "token1_symbol": {
            "type": "string",
            "description": "The symbol of the second token involved in the swap.",
            "example": "ETH"
          },
          "token1_icon_link": {
            "type": "string",
            "description": "A link to the icon of the token involved in the transaction.",
            "example": "https://logos.uniwhales.io/ethereum/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2.jpg"
          },
          "first_interaction": {
            "type": "boolean",
            "description": "Indicates whether this transaction was the first interaction between the involved wallet addresses.",
            "example": "falsed"
          },
          "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.",
                "example": "0x7f5c764cbc14f9669b88837ca1490cca17c31607"
              },
              "market_cap": {
                "type": "number",
                "format": "double",
                "description": "The market capitalization of the token.",
                "example": 28567534.5964843
              },
              "liquidity": {
                "type": "number",
                "format": "double",
                "description": "The liquidity of the token.",
                "example": 832322.8431867727
              }
            },
            "required": [
              "token_address",
              "market_cap",
              "liquidity"
            ]
          },
          "is_sell": {
            "type": "boolean",
            "description": "Indicates whether the swap transaction was a sell order.",
            "example": false
          }
        },
        "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"
        ]
      },
      "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.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "wallet_label": {
            "type": "string",
            "description": "A readable label for the wallet address.",
            "example": "0xa4c8...f9457d"
          },
          "tx_hash": {
            "type": "string",
            "description": "The unique hash identifier of the transfer transaction.",
            "example": "0xe0f84917036e7e2ebb2f8d73199547bde30d4d2918c67904a4bb200dc5bad215"
          },
          "tx_type": {
            "type": "string",
            "description": "Specifies the type of transaction, in this case, a token transfer.",
            "example": "transfer"
          },
          "chain": {
            "type": "string",
            "description": "The blockchain network where the transfer transaction occurred.",
            "example": "optimism"
          },
          "index": {
            "type": "integer",
            "description": "A numerical index or identifier for the transaction.",
            "example": 10
          },
          "timestamp": {
            "type": "integer",
            "description": "The timestamp marking when the transaction was executed.",
            "example": 1702899395
          },
          "block": {
            "type": "integer",
            "description": "The block number on the blockchain where this transaction is recorded.",
            "example": 113650309
          },
          "from": {
            "type": "string",
            "description": "The originating wallet address of the transaction.",
            "example": "0xebc18d25d8122da21f73a6bcb78971671f21f6ff"
          },
          "to": {
            "type": "string",
            "description": "The destination wallet address of the transaction.",
            "example": "0xcfdbdb8723619bca23765e09d59c8f745366f8ff"
          },
          "from_label": {
            "type": "string",
            "description": "A readable version of the 'from' wallet address.",
            "example": "0xebc18d25d8122da21f73a6bcb78971671f21f6ff"
          },
          "to_label": {
            "type": "string",
            "description": "A readable version of the 'to' wallet address.",
            "example": "0xcfdb...6f8ff"
          },
          "amount_usd": {
            "type": "number",
            "format": "double",
            "description": "The USD value of the amount transferred in the transaction.",
            "example": 117.412291
          },
          "contract_address": {
            "type": "string",
            "description": "The blockchain address of the contract under which the token is registered.",
            "example": "0xdac17f958d2ee523a2206206994597c13d831ec7"
          },
          "name": {
            "type": "string",
            "description": "The name of the token being transferred.",
            "example": "Tether USD"
          },
          "symbol": {
            "type": "string",
            "description": "The symbol of the token being transferred.",
            "example": "USDT"
          },
          "token_price_usd": {
            "type": "number",
            "format": "double",
            "description": "The price of the token in USD at the time of the transaction.",
            "example": 1
          },
          "type": {
            "type": "string",
            "description": "Indicates the contract standard of the token, such as ERC20.",
            "example": "ERC20"
          },
          "token_icon_link": {
            "type": "string",
            "description": "A URL link to the token's icon image.",
            "example": "https://logos.uniwhales.io/ethereum/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2.jpg"
          },
          "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.",
                "example": "0x7f5c764cbc14f9669b88837ca1490cca17c31607"
              },
              "market_cap": {
                "type": "number",
                "format": "double",
                "description": "The market capitalization of the token.",
                "example": 28567534.5964843
              },
              "liquidity": {
                "type": "number",
                "format": "double",
                "description": "The liquidity of the token.",
                "example": 832322.8431867727
              }
            },
            "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"
        ]
      },
      "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.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "wallet_label": {
            "type": "string",
            "description": "A human-readable label or name associated with the wallet, such as a ENS name.",
            "example": "vitalik.eth"
          },
          "tx_hash": {
            "type": "string",
            "description": "The unique transaction hash identifying this specific LP transaction.",
            "example": "0xe0f84917036e7e2ebb2f8d73199547bde30d4d2918c67904a4bb200dc5bad215"
          },
          "tx_type": {
            "type": "string",
            "description": "Indicates the type of transaction, in this case, liquidity pool (LP) related.",
            "example": "lp"
          },
          "chain": {
            "type": "string",
            "description": "The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place.",
            "example": "optimism"
          },
          "index": {
            "type": "integer",
            "description": "A numerical index or identifier for the transaction.",
            "example": 10
          },
          "timestamp": {
            "type": "integer",
            "description": "The timestamp marking when the transaction was executed.",
            "example": 1702899395
          },
          "block": {
            "type": "integer",
            "description": "The block number on the blockchain where this transaction is recorded.",
            "example": 113650309
          },
          "from": {
            "type": "string",
            "description": "The originating wallet address for the transaction.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "to": {
            "type": "string",
            "description": "The destination wallet address for the transaction.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "contract_address": {
            "type": "string",
            "description": "The address of the smart contract involved in the interaction.",
            "example": "0x7f5c764cbc14f9669b88837ca1490cca17c31607"
          },
          "contract_label": {
            "type": "string",
            "description": "A human-readable label or name associated with the smart contract.",
            "example": "Uniswap V3"
          }
        },
        "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.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "wallet_label": {
            "type": "string",
            "description": "A human-readable label or name associated with the wallet, such as a ENS name.",
            "example": "vitalik.eth"
          },
          "tx_hash": {
            "type": "string",
            "description": "The unique transaction hash identifying this specific LP transaction.",
            "example": "0xe0f84917036e7e2ebb2f8d73199547bde30d4d2918c67904a4bb200dc5bad215"
          },
          "tx_type": {
            "type": "string",
            "description": "Indicates the type of transaction, in this case, liquidity pool (LP) related.",
            "example": "lp"
          },
          "chain": {
            "type": "string",
            "description": "The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place.",
            "example": "optimism"
          },
          "index": {
            "type": "integer",
            "description": "A numerical index or identifier for the transaction.",
            "example": 10
          },
          "timestamp": {
            "type": "integer",
            "description": "The timestamp marking when the transaction was executed.",
            "example": 1702899395
          },
          "block": {
            "type": "integer",
            "description": "The block number on the blockchain where this transaction is recorded.",
            "example": 113650309
          },
          "dex": {
            "type": "string",
            "description": "The decentralized exchange where the wrap transaction occurred.",
            "example": "Uniswap"
          },
          "from": {
            "type": "string",
            "description": "The originating wallet address for the transaction.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "to": {
            "type": "string",
            "description": "The destination wallet address for the transaction.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "action": {
            "type": "string"
          },
          "amount": {
            "type": "number",
            "description": "The amount of tokens wrapped in the transaction.",
            "example": 100
          },
          "amount_usd": {
            "type": "number",
            "description": "The equivalent amount in USD of the wrapped tokens.",
            "example": "100.0"
          },
          "contract_address": {
            "type": "string",
            "description": "The address of the smart contract involved in the interaction.",
            "example": "0x7f5c764cbc14f9669b88837ca1490cca17c31607"
          },
          "name": {
            "type": "string",
            "description": "The name of the token wrapped in the transaction.",
            "example": "Wrapped Ether"
          },
          "symbol": {
            "type": "string",
            "description": "The symbol of the token wrapped in the transaction.",
            "example": "WETH"
          },
          "token_price_usd": {
            "type": "number",
            "description": "The price of the token in USD at the time of the transaction.",
            "example": "100.0"
          },
          "token_type": {
            "type": "string",
            "description": "The type of token wrapped in the transaction.",
            "example": "ERC20"
          },
          "token_icon_link": {
            "type": "string",
            "description": "A link to the icon of the token involved in the transaction.",
            "example": "https://logos.uniwhales.io/ethereum/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2.jpg"
          }
        },
        "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.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "wallet_label": {
            "type": "string",
            "description": "A human-readable label or name associated with the wallet, such as a ENS name.",
            "example": "vitalik.eth"
          },
          "tx_hash": {
            "type": "string",
            "description": "The unique transaction hash identifying this specific LP transaction.",
            "example": "0xe0f84917036e7e2ebb2f8d73199547bde30d4d2918c67904a4bb200dc5bad215"
          },
          "tx_type": {
            "type": "string",
            "description": "Indicates the type of transaction, in this case, liquidity pool (LP) related.",
            "example": "lp"
          },
          "chain": {
            "type": "string",
            "description": "The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place.",
            "example": "optimism"
          },
          "index": {
            "type": "integer",
            "description": "A numerical index or identifier for the transaction.",
            "example": 10
          },
          "timestamp": {
            "type": "integer",
            "description": "The timestamp marking when the transaction was executed.",
            "example": 1702899395
          },
          "block": {
            "type": "integer",
            "description": "The block number on the blockchain where this transaction is recorded.",
            "example": 113650309
          },
          "dex": {
            "type": "string",
            "description": "The decentralized exchange where the wrap transaction occurred.",
            "example": "Uniswap"
          },
          "from": {
            "type": "string",
            "description": "The originating wallet address for the transaction.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "nft_address": {
            "type": "string",
            "description": "The address of the NFT contract involved in the interaction.",
            "example": "0x7f5c764cbc14f9669b88837ca1490cca17c31607"
          },
          "nft_amount": {
            "type": "integer",
            "description": "The amount of NFTs involved in the transaction.",
            "example": 1
          },
          "nft_price": {
            "type": "number",
            "description": "The price of the NFT in the transaction.",
            "example": 100
          },
          "nft_symbol": {
            "type": "string",
            "description": "The symbol of the NFT in the transaction.",
            "example": "NFT"
          },
          "to": {
            "type": "string",
            "description": "The destination wallet address for the transaction.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "token0_address": {
            "type": "string",
            "description": "The address of the first token in the LP pair.",
            "example": "0x7f5c764cbc14f9669b88837ca1490cca17c31607"
          },
          "token0_amount": {
            "type": "number",
            "description": "The amount of the first token in the LP pair.",
            "example": 100
          },
          "token0_amount_usd": {
            "type": "number",
            "description": "The equivalent amount in USD of the first token in the LP pair.",
            "example": 100
          },
          "token0_name": {
            "type": "string",
            "description": "The name of the first token in the LP pair.",
            "example": "Wrapped Ether"
          },
          "token0_price_usd": {
            "type": "number",
            "description": "The price of the first token in the LP pair in USD.",
            "example": 100
          },
          "token0_symbol": {
            "type": "string",
            "description": "The symbol of the first token in the LP pair.",
            "example": "WETH"
          },
          "token0_icon_link": {
            "type": "string",
            "description": "A link to the icon of the token involved in the transaction.",
            "example": "https://logos.uniwhales.io/ethereum/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2.jpg"
          }
        },
        "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.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "wallet_label": {
            "type": "string",
            "description": "A human-readable label or name associated with the wallet, such as a ENS name.",
            "example": "vitalik.eth"
          },
          "tx_hash": {
            "type": "string",
            "description": "The unique transaction hash identifying this specific LP transaction.",
            "example": "0xe0f84917036e7e2ebb2f8d73199547bde30d4d2918c67904a4bb200dc5bad215"
          },
          "tx_type": {
            "type": "string",
            "description": "Indicates the type of transaction, in this case, liquidity pool (LP) related.",
            "example": "lp"
          },
          "chain": {
            "type": "string",
            "description": "The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place.",
            "example": "optimism"
          },
          "index": {
            "type": "integer",
            "description": "A numerical index or identifier for the transaction.",
            "example": 10
          },
          "timestamp": {
            "type": "integer",
            "description": "The timestamp marking when the transaction was executed.",
            "example": 1702899395
          },
          "block": {
            "type": "integer",
            "description": "The block number on the blockchain where this transaction is recorded.",
            "example": 113650309
          },
          "address": {
            "type": "string",
            "description": "The address of the token involved in the transaction.",
            "example": "0x7f5c764cbc14f9669b88837ca1490cca17c31607"
          },
          "amount": {
            "type": "number",
            "description": "The amount of tokens involved in the transaction.",
            "example": 100
          },
          "amount_usd": {
            "type": "number",
            "description": "The equivalent amount in USD of the tokens involved in the transaction.",
            "example": 100
          },
          "from": {
            "type": "string",
            "description": "The originating wallet address for the transaction.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "name": {
            "type": "string",
            "description": "The name of the token involved in the transaction.",
            "example": "Wrapped Ether"
          },
          "price_usd": {
            "type": "number",
            "description": "The price of the token in USD.",
            "example": 100
          },
          "symbol": {
            "type": "string",
            "description": "The symbol of the token involved in the transaction.",
            "example": "WETH"
          }
        },
        "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.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "wallet_label": {
            "type": "string",
            "description": "A human-readable label or name associated with the wallet, such as a ENS name.",
            "example": "vitalik.eth"
          },
          "tx_hash": {
            "type": "string",
            "description": "The unique transaction hash identifying this specific LP transaction.",
            "example": "0xe0f84917036e7e2ebb2f8d73199547bde30d4d2918c67904a4bb200dc5bad215"
          },
          "tx_type": {
            "type": "string",
            "description": "Indicates the type of transaction, in this case, liquidity pool (LP) related.",
            "example": "lp"
          },
          "chain": {
            "type": "string",
            "description": "The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place.",
            "example": "optimism"
          },
          "index": {
            "type": "integer",
            "description": "A numerical index or identifier for the transaction.",
            "example": 10
          },
          "timestamp": {
            "type": "integer",
            "description": "The timestamp marking when the transaction was executed.",
            "example": 1702899395
          },
          "block": {
            "type": "integer",
            "description": "The block number on the blockchain where this transaction is recorded.",
            "example": 113650309
          },
          "from": {
            "type": "string",
            "description": "The originating wallet address for the transaction.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "to": {
            "type": "string",
            "description": "The destination wallet address for the transaction.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "from_label": {
            "type": "string",
            "description": "A human-readable label or name associated with the originating wallet.",
            "example": "Alice"
          },
          "to_label": {
            "type": "string",
            "description": "A human-readable label or name associated with the destination wallet.",
            "example": "Bob"
          },
          "amount": {
            "type": "number",
            "description": "The amount of tokens staked in the transaction.",
            "example": 100
          },
          "amount_usd": {
            "type": "number",
            "description": "The equivalent amount in USD of the staked tokens.",
            "example": 100
          },
          "token_price_usd": {
            "type": "number",
            "description": "The price of the token in USD.",
            "example": 100
          },
          "contract_address": {
            "type": "string",
            "description": "The address of the smart contract involved in the interaction.",
            "example": "0x7f5c764cbc14f9669b88837ca1490cca17c31607"
          },
          "symbol": {
            "type": "string",
            "description": "The symbol of the token staked in the transaction.",
            "example": "WETH"
          },
          "name": {
            "type": "string",
            "description": "The name of the token staked in the transaction.",
            "example": "Wrapped Ether"
          },
          "action": {
            "type": "string",
            "description": "The action taken in the staking transaction.",
            "example": "stake"
          }
        },
        "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.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "wallet_label": {
            "type": "string",
            "description": "A human-readable label or name associated with the wallet, such as a ENS name.",
            "example": "vitalik.eth"
          },
          "tx_hash": {
            "type": "string",
            "description": "The unique transaction hash identifying this specific LP transaction.",
            "example": "0xe0f84917036e7e2ebb2f8d73199547bde30d4d2918c67904a4bb200dc5bad215"
          },
          "tx_type": {
            "type": "string",
            "description": "Indicates the type of transaction, in this case, liquidity pool (LP) related.",
            "example": "lp"
          },
          "chain": {
            "type": "string",
            "description": "The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place.",
            "example": "optimism"
          },
          "index": {
            "type": "integer",
            "description": "A numerical index or identifier for the transaction.",
            "example": 10
          },
          "timestamp": {
            "type": "integer",
            "description": "The timestamp marking when the transaction was executed.",
            "example": 1702899395
          },
          "block": {
            "type": "integer",
            "description": "The block number on the blockchain where this transaction is recorded.",
            "example": 113650309
          },
          "action": {
            "type": "string",
            "description": "The action taken in the Perpetual event.",
            "example": "buy"
          },
          "amount_usd": {
            "type": "number",
            "description": "The equivalent amount in USD of the tokens involved in the transaction.",
            "example": 100
          },
          "average_price": {
            "type": "number",
            "description": "The average price of the tokens involved in the transaction.",
            "example": 100
          },
          "base_token_address": {
            "type": "string",
            "description": "The address of the base token involved in the transaction.",
            "example": "0x7f5c764cbc14f9669b88837ca1490cca17c31607"
          },
          "base_token_amount": {
            "type": "number",
            "description": "The amount of base tokens involved in the transaction.",
            "example": 100
          },
          "base_token_symbol": {
            "type": "string",
            "description": "The symbol of the base token involved in the transaction.",
            "example": "ETH"
          },
          "dex": {
            "type": "string",
            "description": "The decentralized exchange where the Perpetual transaction occurred.",
            "example": "Uniswap"
          },
          "from": {
            "type": "string",
            "description": "The originating wallet address for the transaction.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "liquidation": {
            "type": "boolean",
            "description": "Indicates whether the transaction was a liquidation.",
            "example": false
          },
          "liquidation_price": {
            "type": "number",
            "description": "The price at which the liquidation occurred.",
            "example": 100
          },
          "to": {
            "type": "string",
            "description": "The destination wallet address for the transaction.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "trade_direction": {
            "type": "string",
            "description": "The direction of the trade in the Perpetual transaction.",
            "example": "long"
          },
          "perp_details": {
            "type": "string",
            "description": "Additional details about the Perpetual transaction.",
            "example": "details"
          },
          "token0_address": {
            "type": "string",
            "description": "The address of the first token in the LP pair.",
            "example": "0x7f5c764cbc14f9669b88837ca1490cca17c31607"
          },
          "token0_amount": {
            "type": "number",
            "description": "The amount of the first token in the LP pair.",
            "example": 100
          },
          "token0_amount_usd": {
            "type": "number",
            "description": "The equivalent amount in USD of the first token in the LP pair.",
            "example": 100
          },
          "token0_name": {
            "type": "string",
            "description": "The name of the first token in the LP pair.",
            "example": "Wrapped Ether"
          },
          "token0_price_usd": {
            "type": "number",
            "description": "The price of the first token in the LP pair in USD.",
            "example": 100
          },
          "token0_symbol": {
            "type": "string",
            "description": "The symbol of the first token in the LP pair.",
            "example": "WETH"
          },
          "token0_icon_link": {
            "type": "string",
            "description": "A link to the icon of the token involved in the transaction.",
            "example": "https://logos.uniwhales.io/ethereum/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2.jpg"
          },
          "token1_address": {
            "type": "string",
            "description": "The address of the second token in the LP pair.",
            "example": "0x7f5c764cbc14f9669b88837ca1490cca17c31607"
          },
          "token1_amount": {
            "type": "number",
            "description": "The amount of the second token in the LP pair.",
            "example": 100
          },
          "token1_amount_usd": {
            "type": "number",
            "description": "The equivalent amount in USD of the second token in the LP pair.",
            "example": 100
          },
          "token1_name": {
            "type": "string",
            "description": "The name of the second token in the LP pair.",
            "example": "Wrapped Ether"
          },
          "token1_price_usd": {
            "type": "number",
            "description": "The price of the second token in the LP pair in USD.",
            "example": 100
          },
          "token1_symbol": {
            "type": "string",
            "description": "The symbol of the second token in the LP pair.",
            "example": "WETH"
          },
          "token1_icon_link": {
            "type": "string",
            "description": "A link to the icon of the token involved in the transaction.",
            "example": "https://logos.uniwhales.io/ethereum/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2.jpg"
          },
          "realized_pnl": {
            "type": "number",
            "description": "The realized profit and loss of the Perpetual transaction.",
            "example": 100
          },
          "is_nft_perp": {
            "type": "boolean",
            "description": "Indicates whether the Perpetual transaction involves an NFT.",
            "example": false
          },
          "position_size": {
            "type": "number",
            "description": "The size of the position in the Perpetual transaction.",
            "example": 100
          },
          "position_size_usd": {
            "type": "number",
            "description": "The equivalent amount in USD of the position size.",
            "example": 100
          },
          "leverage": {
            "type": "number",
            "description": "The leverage used in the Perpetual transaction.",
            "example": 100
          },
          "unrealized_pnl": {
            "type": "number",
            "description": "The unrealized profit and loss of the Perpetual transaction.",
            "example": 100
          }
        },
        "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.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "wallet_label": {
            "type": "string",
            "description": "A human-readable label or name associated with the wallet, such as a ENS name.",
            "example": "vitalik.eth"
          },
          "tx_hash": {
            "type": "string",
            "description": "The unique transaction hash identifying this specific LP transaction.",
            "example": "0xe0f84917036e7e2ebb2f8d73199547bde30d4d2918c67904a4bb200dc5bad215"
          },
          "tx_type": {
            "type": "string",
            "description": "Indicates the type of transaction, in this case, liquidity pool (LP) related.",
            "example": "lp"
          },
          "chain": {
            "type": "string",
            "description": "The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place.",
            "example": "optimism"
          },
          "index": {
            "type": "integer",
            "description": "A numerical index or identifier for the transaction.",
            "example": 10
          },
          "timestamp": {
            "type": "integer",
            "description": "The timestamp marking when the transaction was executed.",
            "example": 1702899395
          },
          "block": {
            "type": "integer",
            "description": "The block number on the blockchain where this transaction is recorded.",
            "example": 113650309
          },
          "address": {
            "type": "string",
            "description": "The address of the token involved in the transaction.",
            "example": "0x7f5c764cbc14f9669b88837ca1490cca17c31607"
          },
          "amount": {
            "type": "number",
            "description": "The amount of tokens involved in the transaction.",
            "example": 100
          },
          "amount_usd": {
            "type": "number",
            "description": "The equivalent amount in USD of the tokens involved in the transaction.",
            "example": 100
          },
          "dex": {
            "type": "string",
            "description": "The decentralized exchange (DEX) where the flashloan transaction took place.",
            "example": "Uniswap"
          },
          "from": {
            "type": "string",
            "description": "The originating wallet address for the transaction.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "health_factor": {
            "type": "number",
            "description": "The health factor of the wallet after the flashloan transaction.",
            "example": 1
          },
          "name": {
            "type": "string",
            "description": "The name of the token involved in the transaction.",
            "example": "Wrapped Ether"
          },
          "platform": {
            "type": "string",
            "description": "The platform where the flashloan transaction took place.",
            "example": "Aave"
          },
          "price_usd": {
            "type": "number",
            "description": "The price of the token in USD.",
            "example": 100
          },
          "symbol": {
            "type": "string",
            "description": "The symbol of the token involved in the transaction.",
            "example": "ETH"
          },
          "token_icon_link": {
            "type": "string",
            "description": "A link to the icon of the token involved in the transaction.",
            "example": "https://logos.uniwhales.io/ethereum/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2.jpg"
          }
        },
        "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.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "wallet_label": {
            "type": "string",
            "description": "A human-readable label or name associated with the wallet, such as a ENS name.",
            "example": "vitalik.eth"
          },
          "tx_hash": {
            "type": "string",
            "description": "The unique transaction hash identifying this specific LP transaction.",
            "example": "0xe0f84917036e7e2ebb2f8d73199547bde30d4d2918c67904a4bb200dc5bad215"
          },
          "tx_type": {
            "type": "string",
            "description": "Indicates the type of transaction, in this case, liquidity pool (LP) related.",
            "example": "lp"
          },
          "chain": {
            "type": "string",
            "description": "The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place.",
            "example": "optimism"
          },
          "index": {
            "type": "integer",
            "description": "A numerical index or identifier for the transaction.",
            "example": 10
          },
          "timestamp": {
            "type": "integer",
            "description": "The timestamp marking when the transaction was executed.",
            "example": 1702899395
          },
          "block": {
            "type": "integer",
            "description": "The block number on the blockchain where this transaction is recorded.",
            "example": 113650309
          },
          "amount_usd": {
            "type": "number",
            "description": "The equivalent amount in USD of the wrapped tokens.",
            "example": "100.0"
          },
          "contract_address": {
            "type": "string",
            "description": "The address of the smart contract involved in the interaction.",
            "example": "0x7f5c764cbc14f9669b88837ca1490cca17c31607"
          },
          "from": {
            "type": "string",
            "description": "The originating wallet address for the transaction.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "from_label": {
            "type": "string",
            "description": "A human-readable label or name associated with the originating wallet.",
            "example": "Alice"
          }
        },
        "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.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "wallet_label": {
            "type": "string",
            "description": "A human-readable label or name associated with the wallet, such as a ENS name.",
            "example": "vitalik.eth"
          },
          "tx_hash": {
            "type": "string",
            "description": "The unique transaction hash identifying this specific LP transaction.",
            "example": "0xe0f84917036e7e2ebb2f8d73199547bde30d4d2918c67904a4bb200dc5bad215"
          },
          "tx_type": {
            "type": "string",
            "description": "Indicates the type of transaction, in this case, liquidity pool (LP) related.",
            "example": "lp"
          },
          "chain": {
            "type": "string",
            "description": "The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place.",
            "example": "optimism"
          },
          "index": {
            "type": "integer",
            "description": "A numerical index or identifier for the transaction.",
            "example": 10
          },
          "timestamp": {
            "type": "integer",
            "description": "The timestamp marking when the transaction was executed.",
            "example": 1702899395
          },
          "block": {
            "type": "integer",
            "description": "The block number on the blockchain where this transaction is recorded.",
            "example": 113650309
          },
          "contract_address": {
            "type": "string",
            "description": "The address of the NFT contract involved in the interaction.",
            "example": "0x7f5c764cbc14f9669b88837ca1490cca17c31607"
          },
          "currency_address": {
            "type": "string",
            "description": "The address of the currency involved in the transaction.",
            "example": "0x7f5c764cbc14f9669b88837ca1490cca17c31607"
          },
          "currency_symbol": {
            "type": "string",
            "description": "The symbol of the currency involved in the transaction.",
            "example": "ETH"
          },
          "dex": {
            "type": "string",
            "description": "The decentralized exchange where the wrap transaction occurred.",
            "example": "Uniswap"
          },
          "from": {
            "type": "string",
            "description": "The originating wallet address for the transaction.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "nft_address": {
            "type": "string",
            "description": "The address of the NFT contract involved in the interaction.",
            "example": "0x7f5c764cbc14f9669b88837ca1490cca17c31607"
          },
          "nft_name": {
            "type": "string",
            "description": "The name of the NFT in the transaction.",
            "example": "NFT"
          },
          "nft_symbol": {
            "type": "string",
            "description": "The symbol of the NFT in the transaction.",
            "example": "NFT"
          },
          "platform": {
            "type": "string",
            "description": "The platform where the flashloan transaction took place.",
            "example": "Aave"
          },
          "price": {
            "type": "number",
            "description": "The price of the NFT in the transaction.",
            "example": 100
          },
          "price_usd": {
            "type": "number",
            "description": "The price of the NFT in USD.",
            "example": 100
          },
          "to": {
            "type": "string",
            "description": "The destination wallet address for the transaction.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "token_id": {
            "type": "string",
            "description": "The unique identifier of the NFT in the transaction.",
            "example": "1"
          }
        },
        "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.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "wallet_label": {
            "type": "string",
            "description": "A human-readable label or name associated with the wallet, such as a ENS name.",
            "example": "vitalik.eth"
          },
          "tx_hash": {
            "type": "string",
            "description": "The unique transaction hash identifying this specific LP transaction.",
            "example": "0xe0f84917036e7e2ebb2f8d73199547bde30d4d2918c67904a4bb200dc5bad215"
          },
          "tx_type": {
            "type": "string",
            "description": "Indicates the type of transaction, in this case, liquidity pool (LP) related.",
            "example": "lp"
          },
          "chain": {
            "type": "string",
            "description": "The blockchain network (e.g., Ethereum, Optimism) where this transaction takes place.",
            "example": "optimism"
          },
          "index": {
            "type": "integer",
            "description": "A numerical index or identifier for the transaction.",
            "example": 10
          },
          "timestamp": {
            "type": "integer",
            "description": "The timestamp marking when the transaction was executed.",
            "example": 1702899395
          },
          "block": {
            "type": "integer",
            "description": "The block number on the blockchain where this transaction is recorded.",
            "example": 113650309
          },
          "action": {
            "type": "string",
            "description": "The action taken in the option event.",
            "example": "buy"
          },
          "amount": {
            "type": "number",
            "description": "The amount of tokens involved in the transaction.",
            "example": 100
          },
          "asset": {
            "type": "string",
            "description": "The asset involved in the option event.",
            "example": "ETH"
          },
          "dex": {
            "type": "string",
            "description": "The decentralized exchange (DEX) where the option event took place.",
            "example": "Uniswap"
          },
          "direction": {
            "type": "string",
            "description": "The direction of the option event.",
            "example": "call"
          },
          "expiry": {
            "type": "string",
            "description": "The expiry date of the option.",
            "example": "2022-12-31"
          },
          "from": {
            "type": "string",
            "description": "The originating wallet address for the transaction.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "option_price_usd": {
            "type": "number",
            "description": "The price of the option in USD.",
            "example": 100
          },
          "position_status": {
            "type": "string",
            "description": "The status of the option position.",
            "example": "open"
          },
          "spot_price_usd": {
            "type": "number",
            "description": "The spot price of the asset in USD.",
            "example": 100
          },
          "status": {
            "type": "string",
            "description": "The status of the option event.",
            "example": "active"
          },
          "strike_price_usd": {
            "type": "number",
            "description": "The strike price of the option in USD.",
            "example": 100
          },
          "to": {
            "type": "string",
            "description": "The destination wallet address for the transaction.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "type": {
            "type": "string",
            "description": "The type of option event.",
            "example": "call"
          }
        },
        "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.",
            "example": "0xb4fb31e7b1471a8e52dd1e962a281a732ead59c1"
          },
          "wallet_label": {
            "type": "string",
            "description": "A readable label for the wallet address.",
            "example": "0xa4c8...f9457d"
          },
          "tx_hash": {
            "type": "string",
            "description": "The unique hash identifier of the NFT trading transaction.",
            "example": "0xe0f84917036e7e2ebb2f8d73199547bde30d4d2918c67904a4bb200dc5bad215"
          },
          "tx_type": {
            "type": "string",
            "description": "Specifies the type of transaction, in this case, NFT trading.",
            "example": "nft_trade"
          },
          "chain": {
            "type": "string",
            "description": "The blockchain network where the trading transaction occurred.",
            "example": "ethereum"
          },
          "index": {
            "type": "integer",
            "description": "A numerical index or identifier for the transaction.",
            "example": 10
          },
          "timestamp": {
            "type": "integer",
            "description": "The timestamp marking when the transaction was executed.",
            "example": 1702899395
          },
          "block": {
            "type": "integer",
            "description": "The block number on the blockchain where this transaction is recorded.",
            "example": 113650309
          },
          "from": {
            "type": "string",
            "description": "The originating wallet address of the transaction.",
            "example": "0xebc18d25d8122da21f73a6bcb78971671f21f6ff"
          },
          "to": {
            "type": "string",
            "description": "The destination wallet address of the transaction.",
            "example": "0xcfdbdb8723619bca23765e09d59c8f745366f8ff"
          },
          "thumbnail": {
            "type": "string",
            "description": "A thumbnail image URL of the NFT involved in the transaction.",
            "example": "https://res.cloudinary.com/alchemyapi/image/upload/thumbnailv2/matic-mainnet/284ed679247466683591389baddcfc9b"
          },
          "image": {
            "type": "string",
            "description": "A full image URL of the NFT.",
            "example": "https://nft-cdn.alchemy.com/matic-mainnet/284ed679247466683591389baddcfc9b"
          },
          "action": {
            "type": "string",
            "description": "Describes the action taken in the NFT trade, such as 'buy' or 'sell'.",
            "example": "buy"
          },
          "contract": {
            "type": "string",
            "description": "The blockchain contract address associated with the NFT.",
            "example": "0x00000000000000adc04c56bf30ac9d3c0aaf14dc"
          },
          "marketplace": {
            "type": "string",
            "description": "The marketplace where the NFT trade occurred, such as OpenSea.",
            "example": "OpenSea"
          },
          "nft_address": {
            "type": "string",
            "description": "The blockchain address of the NFT involved in the trade.",
            "example": "0xbe9371326f91345777b04394448c23e2bfeaa826"
          },
          "nft_name": {
            "type": "string",
            "description": "The name of the NFT traded.",
            "example": "Gemesis"
          },
          "nft_symbol": {
            "type": "string",
            "description": "The symbol associated with the NFT.",
            "example": "OSP"
          },
          "nft_token_id": {
            "type": "string",
            "description": "The unique token ID of the NFT involved in the trade.",
            "example": 32507
          },
          "price": {
            "type": "number",
            "format": "double",
            "description": "The price at which the NFT was traded.",
            "example": 0.0151
          },
          "price_usd": {
            "type": "number",
            "format": "double",
            "description": "The equivalent USD value of the NFT trade.",
            "example": 32.911356
          },
          "profit": {
            "type": "number",
            "format": "double",
            "description": "The profit earned from the trade. This may be zero in some transactions.",
            "example": 0
          },
          "currency_symbol": {
            "type": "string",
            "description": "The symbol of the currency used in the trade, such as WETH or ETH.",
            "example": "WETH"
          },
          "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"
        ]
      },
      "PortfolioAsset": {
        "type": "object",
        "properties": {
          "chain": {
            "type": "string",
            "description": "The chain of the token.",
            "example": "solana"
          },
          "token_address": {
            "type": "string",
            "description": "The token address.",
            "example": "Fs8EHRVCes9SrPBWbLPTuSRBiCT8d53d8AWwaMLjHaid"
          },
          "token_name": {
            "type": "string",
            "description": "The token name.",
            "example": "USDT"
          },
          "token_symbol": {
            "type": "string",
            "description": "The token symbol.",
            "example": "USDT"
          },
          "platform": {
            "type": "string",
            "description": "The token launch platform code.",
            "example": "pump-fun"
          },
          "platform_ui": {
            "type": "string",
            "description": "The human-readable token launch platform name.",
            "example": "Pump.fun"
          },
          "token_price_usd": {
            "type": "number",
            "description": "The token price in USD.",
            "example": 0.9999
          },
          "balance": {
            "type": "number",
            "description": "The token balance.",
            "example": 12609.138159
          },
          "total_usd_value": {
            "type": "number",
            "description": "The total USD value.",
            "example": 12607.8772451841
          },
          "supply": {
            "type": "number",
            "description": "The token supply.",
            "example": 1889938292.793473
          },
          "supply_owned": {
            "type": "number",
            "description": "The token supply owned.",
            "example": 0.0006671719498504224
          }
        },
        "required": [
          "token_address",
          "token_name",
          "token_symbol",
          "token_price_usd",
          "balance",
          "total_usd_value",
          "supply",
          "supply_owned"
        ]
      },
      "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.",
                "example": 12607.8772451841
              },
              "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"
        ]
      },
      "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."
                  }
                }
              }
            }
          }
        }
      },
      "WalletTokenPosition": {
        "type": "object",
        "properties": {
          "chain": {
            "type": "string",
            "example": "solana"
          },
          "wallet": {
            "type": "string",
            "example": "9W7CCnAvviXzP9ToyfCBT4aYbn845HdZSWS7kZPZ96mg"
          },
          "token_address": {
            "type": "string",
            "example": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"
          },
          "token_symbol": {
            "type": "string",
            "example": "BONK"
          },
          "token_name": {
            "type": "string",
            "example": "Bonk"
          },
          "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."
          }
        }
      }
    },
    "responses": {
      "FeedResponse": {
        "description": "Successfull Feed response",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Feed"
            }
          }
        }
      },
      "TokensPNLResponse": {
        "description": "Successfull tokens PnL response",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/TokensPNL"
            }
          }
        }
      },
      "NftsPnLResponse": {
        "description": "Successfull Nft PnL response",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/NftsPnL"
            }
          }
        }
      },
      "TotalStatsResponse": {
        "description": "Successfull Total Stats response",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/TotalStats"
            }
          }
        }
      },
      "TagsResponse": {
        "description": "Successfull Tags response",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Tags"
            }
          }
        }
      },
      "RelatedWalletsResponse": {
        "description": "Successfull Related Wallets response",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/RelatedWallets"
            }
          }
        }
      },
      "WalletsByTagResponse": {
        "description": "Successfull Wallets by Tag response",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/WalletsByTag"
            }
          }
        }
      },
      "TradingStatsResponse": {
        "description": "Trading stats response",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "data": {
                  "type": "object",
                  "properties": {
                    "total_trades": {
                      "type": "integer",
                      "description": "Total number of trades",
                      "example": 150
                    },
                    "successful_trades": {
                      "type": "integer",
                      "description": "Number of successful trades",
                      "example": 120
                    },
                    "failed_trades": {
                      "type": "integer",
                      "description": "Number of failed trades",
                      "example": 30
                    },
                    "win_rate": {
                      "type": "number",
                      "format": "float",
                      "description": "Win rate percentage",
                      "example": 80
                    },
                    "average_profit": {
                      "type": "number",
                      "format": "float",
                      "description": "Average profit per trade",
                      "example": 0.15
                    },
                    "total_profit": {
                      "type": "number",
                      "format": "float",
                      "description": "Total profit",
                      "example": 22.5
                    },
                    "total_volume": {
                      "type": "number",
                      "format": "float",
                      "description": "Total trading volume",
                      "example": 150
                    },
                    "most_traded_token": {
                      "type": "string",
                      "description": "Most frequently traded token",
                      "example": "USDC"
                    },
                    "most_profitable_token": {
                      "type": "string",
                      "description": "Most profitable token",
                      "example": "ETH"
                    },
                    "trading_frequency": {
                      "type": "string",
                      "description": "Trading frequency (e.g., \"daily\", \"weekly\", \"monthly\")",
                      "example": "daily"
                    },
                    "last_trade_timestamp": {
                      "type": "integer",
                      "description": "Unix timestamp of the last trade",
                      "example": 1678901234
                    }
                  }
                }
              },
              "required": [
                "data"
              ]
            }
          }
        }
      },
      "TokenFlowsV2Response": {
        "description": "Token flows response",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "ok"
                },
                "message": {
                  "type": "string",
                  "example": "success"
                },
                "data": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/TokenFlowV2Item"
                      }
                    },
                    "paging": {
                      "$ref": "#/components/schemas/Paging"
                    }
                  }
                }
              }
            }
          }
        }
      },
      "NewTokenFlowsResponse": {
        "description": "New token flows response",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "example": "ok"
                },
                "message": {
                  "type": "string",
                  "example": "success"
                },
                "data": {
                  "type": "object",
                  "properties": {
                    "tokens": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/NewTokenFlowItem"
                      }
                    },
                    "paging": {
                      "$ref": "#/components/schemas/Paging"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "securitySchemes": {
      "api_key": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-KEY"
      }
    }
  }
}
