openapi.json

{
  "openapi": "3.0.3",
  "info": {
    "title": "Sim API",
    "description": "The Sim API by Dune provides real-time blockchain data across EVM and SVM chains. Access token balances, transaction history, on-chain activity, DeFi positions, NFT collectibles, token information, and webhook subscriptions through a unified REST API.",
    "version": "1.0.0",
    "license": {
      "name": ""
    },
    "contact": {
      "name": "Dune Support",
      "url": "https://docs.sim.dune.com",
      "email": "support@dune.com"
    }
  },
  "servers": [
    {
      "url": "https://api.sim.dune.com"
    }
  ],
  "tags": [
    {
      "name": "evm",
      "description": "EVM-compatible blockchain endpoints."
    },
    {
      "name": "svm",
      "description": "Solana/SVM blockchain endpoints."
    },
    {
      "name": "activity",
      "description": "On-chain activity feed."
    },
    {
      "name": "balances",
      "description": "Token balances (EVM and SVM)."
    },
    {
      "name": "transactions",
      "description": "Transaction history (EVM and SVM)."
    },
    {
      "name": "collectibles",
      "description": "NFT and ERC721/ERC1155 holdings."
    },
    {
      "name": "defi",
      "description": "DeFi protocol positions."
    },
    {
      "name": "supported-chains",
      "description": "Supported blockchain networks."
    },
    {
      "name": "token-info",
      "description": "Token metadata and pricing."
    },
    {
      "name": "token-holders",
      "description": "Token holder distribution."
    },
    {
      "name": "subscriptions",
      "description": "Webhook subscription management for real-time on-chain event notifications."
    }
  ],
  "paths": {
    "/v1/evm/activity/{address}": {
      "get": {
        "tags": [
          "evm",
          "activity"
        ],
        "summary": "Get EVM activity for a given address",
        "description": "This endpoint provides a real-time feed of on-chain activity for any EVM address. Activity is returned in chronological order (newest first) and includes native token transfers, ERC20 token transfers with metadata, ERC721 (NFT) transfers with token IDs, and contract interactions with decoded function calls.",
        "operationId": "getEvmActivity",
        "parameters": [
          {
            "name": "address",
            "in": "path",
            "description": "Wallet address to get activity for",
            "required": true,
            "schema": {
              "type": "string",
              "format": "address",
              "pattern": "^0x[a-fA-F0-9]{40}$",
              "default": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
            },
            "example": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
          },
          {
            "name": "chain_ids",
            "in": "query",
            "required": false,
            "description": "Filter by chain(s). Accepts numeric chain IDs and/or tags. Provide a single value (e.g. `?chain_ids=1` or `?chain_ids=mainnet`) or a comma-separated list (e.g. `?chain_ids=1,8543,testnet`). Chain names are not accepted. If this query parameter is omitted, results include activity from chains with the `default` tag. See the [Supported Chains Tags](/evm/supported-chains#tags) section.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "description": "The offset to paginate through result sets. This is a cursor being passed from the previous response, only use what the backend returns here.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of activity items to return. Default is 20 when not provided. Values above 100 are reduced to 100.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            }
          },
          {
            "name": "token_address",
            "in": "query",
            "description": "Filter activities by token contract address. Provide a single address (e.g. `?token_address=0xa0b8...`) or a comma-separated list (e.g. `?token_address=0xa0b8...,0xdac1...`). Only activities involving the specified token(s) will be returned. Swap and call activities are excluded when this filter is set, as they do not have a single token address. Native transfers are also excluded since they have no token contract.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
          },
          {
            "name": "activity_type",
            "in": "query",
            "description": "Filter activities by type. Provide a single value (e.g. `?activity_type=send`) or a comma-separated list (e.g. `?activity_type=send,receive`). Only activities matching one of the specified types will be returned.",
            "required": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "approve",
                  "burn",
                  "call",
                  "mint",
                  "receive",
                  "send",
                  "swap",
                  "transfer"
                ]
              }
            },
            "example": [
              "send",
              "receive"
            ],
            "style": "form",
            "explode": false
          },
          {
            "name": "asset_type",
            "in": "query",
            "description": "Filter activities by asset standard. Provide a single value (e.g. `?asset_type=native`) or a comma-separated list (e.g. `?asset_type=erc20,erc721`). Use `native` to include native token transfers (e.g. ETH). Contract call activities have no asset type and are excluded when this filter is set.",
            "required": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "native",
                  "erc20",
                  "erc721",
                  "erc1155"
                ]
              }
            },
            "example": [
              "erc20"
            ],
            "style": "form",
            "explode": false
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ActivityResponse"
                },
                "examples": {
                  "success": {
                    "summary": "Successful response",
                    "value": {
                      "activity": [
                        {
                          "chain_id": 8453,
                          "block_number": 26635101,
                          "block_time": "2025-02-20T13:52:29+00:00",
                          "tx_hash": "0x184544c8d67a0cbed0a3f04abe5f958b96635e8c743c070f70e24b1c06cd1aa6",
                          "type": "receive",
                          "asset_type": "erc20",
                          "token_address": "0xf92e740ad181b13a484a886ed16aa6d32d71b19a",
                          "from": "0xd152f549545093347a162dce210e7293f1452150",
                          "value": "123069652500000000000",
                          "value_usd": 0.14017463965013963,
                          "token_metadata": {
                            "symbol": "ENT",
                            "decimals": 18,
                            "price_usd": 0.001138986230989314,
                            "pool_size": 5.2274054439382835
                          }
                        }
                      ],
                      "next_offset": "KgAAAAAAAAAweDQ4ZDAwNGE2YzE3NWRiMzMxZTk5YmVhZjY0NDIzYjMwOTgzNTdhZTdAVxVC-y0GAAUhAAAAAAAA6XCRAQAAAAAAAAAAAAAAAD0AAAAAAAAAAAAAAAAAAAA"
                    }
                  },
                  "with_warnings": {
                    "summary": "Response with unsupported chain IDs warning",
                    "value": {
                      "activity": [
                        {
                          "chain_id": 1,
                          "block_number": 18500000,
                          "block_time": "2025-02-20T13:52:29+00:00",
                          "tx_hash": "0x184544c8d67a0cbed0a3f04abe5f958b96635e8c743c070f70e24b1c06cd1aa6",
                          "type": "receive",
                          "asset_type": "erc20",
                          "token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
                          "from": "0xd152f549545093347a162dce210e7293f1452150",
                          "value": "1000000",
                          "value_usd": 1,
                          "token_metadata": {
                            "symbol": "USDC",
                            "decimals": 6,
                            "price_usd": 1
                          }
                        }
                      ],
                      "warnings": [
                        {
                          "code": "UNSUPPORTED_CHAIN_IDS",
                          "message": "Some requested chain_ids are not supported. Activity is returned only for supported chains.",
                          "chain_ids": [
                            9999,
                            77777777777
                          ],
                          "docs_url": "https://docs.sim.dune.com/evm/supported-chains"
                        }
                      ],
                      "next_offset": "KgAAAAAAAAAweDQ4ZDAwNGE2YzE3NWRiMzMxZTk5YmVhZjY0NDIzYjMwOTgzNTdhZTdAVxVC-y0GAAUhAAAAAAAA6XCRAQAAAAAAAAAAAAAAAD0AAAAAAAAAAAAAAAAAAAA"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - Invalid address or validation error.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "examples": {
                  "validationError": {
                    "summary": "Validation error",
                    "value": "Invalid address format"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized - Invalid or missing API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "invalidApiKey": {
                    "value": {
                      "error": "invalid API Key"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate Limit Exceeded - Too many requests.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "rateLimitExceeded": {
                    "value": {
                      "error": "Too many requests. Please contact sales@dune.com to increase your limit."
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "examples": {
                  "internalError": {
                    "summary": "Internal server error",
                    "value": "Internal server error"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/evm/balances/{address}": {
      "get": {
        "tags": [
          "evm",
          "balances"
        ],
        "summary": "Get EVM token balances for a given address",
        "description": "This endpoint returns EVM token balances for an address for any token that the address has interacted with",
        "operationId": "getEvmBalances",
        "parameters": [
          {
            "name": "address",
            "in": "path",
            "description": "Wallet address to get balances for",
            "required": true,
            "schema": {
              "type": "string",
              "format": "address",
              "pattern": "^0x[a-fA-F0-9]{40}$",
              "default": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
            }
          },
          {
            "name": "chain_ids",
            "in": "query",
            "required": false,
            "description": "Filter by chain(s). Accepts numeric chain IDs and/or tags. Provide a single value (e.g. `?chain_ids=1` or `?chain_ids=mainnet`) or a comma-separated list (e.g. `?chain_ids=1,8543,testnet`). Chain names are not accepted. If this query parameter is omitted, results include balances from chains with the `default` tag. See the [Supported Chains Tags](/evm/supported-chains#tags) section.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filters",
            "in": "query",
            "description": "Specify `erc20` or `native` to get only ERC20 tokens or native assets, respectively",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "erc20",
                "native"
              ]
            }
          },
          {
            "name": "asset_class",
            "in": "query",
            "description": "Filter by asset class. Use `stablecoin` to return only stablecoin balances. This is equivalent to using the `/stablecoins` endpoint.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "stablecoin"
              ]
            }
          },
          {
            "name": "metadata",
            "in": "query",
            "description": "A comma separated list of additional metadata fields to include for each token. Supported values: `logo`, `url`, `pools`",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "exclude_spam_tokens",
            "in": "query",
            "description": "When true, excludes tokens with less than 100 USD liquidity from the response. This differs from the `low_liquidity` field in the response.",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "historical_prices",
            "in": "query",
            "description": "Historical price selection. Provide a single integer or a comma-separated list of up to 3 integers representing hours in the past (e.g. `168` for 1 week ago or `720,168,24` for 1 month, 1 week, and 1 day ago). When set, each balance includes a historical_prices array with one entry per offset.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "examples": {
              "single_offset": {
                "summary": "Single offset (1 week ago)",
                "value": "168"
              },
              "three_offsets": {
                "summary": "Three offsets (1 month, 1 week, 1 day ago)",
                "value": "720,168,24"
              }
            }
          },
          {
            "name": "offset",
            "in": "query",
            "description": "The offset to paginate through result sets. This is a cursor being passed from the previous response, only use what the backend returns here.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of balances to return. Default is 1000 when not provided. Values above 1000 are reduced to 1000.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 1000,
              "default": 1000
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BalancesResponse"
                },
                "examples": {
                  "success": {
                    "value": {
                      "wallet_address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
                      "balances": [
                        {
                          "chain": "ethereum",
                          "chain_id": 1,
                          "address": "0x0e36c45d16585d1801e37cfaa577a9ad39f9343a",
                          "amount": "45787557175393926414790300082",
                          "symbol": "Kendu",
                          "name": "Kendu of Bank",
                          "decimals": 18,
                          "price_usd": 1.233346836175539e+21,
                          "value_usd": 5.647193877847869e+31,
                          "pool_size": 1233.34683617554,
                          "low_liquidity": true
                        },
                        {
                          "chain": "ethereum",
                          "chain_id": 1,
                          "address": "0x113404d2003c4acf4231a3a62374bb503bff03d7",
                          "amount": "432599243131405501735524",
                          "symbol": "ALT",
                          "name": "AltLayer",
                          "decimals": 18,
                          "price_usd": 9388386012000030000,
                          "value_usd": 4.061408683016688e+24,
                          "pool_size": 9.38838601200001,
                          "low_liquidity": true
                        }
                      ],
                      "next_offset": "opaque-pagination-token",
                      "request_time": "2025-08-13T10:31:08Z",
                      "response_time": "2025-08-13T10:31:08Z"
                    }
                  },
                  "with_warnings": {
                    "summary": "Response with unsupported chain IDs warning",
                    "value": {
                      "wallet_address": "0x37305b1cd40574e4c5ce33f8e8306be057fd7341",
                      "balances": [
                        {
                          "chain": "ethereum",
                          "chain_id": 1,
                          "address": "native",
                          "amount": "1000000000000000000",
                          "symbol": "ETH",
                          "decimals": 18,
                          "price_usd": 3896.8315,
                          "value_usd": 3896.8315
                        },
                        {
                          "chain": "optimism",
                          "chain_id": 10,
                          "address": "native",
                          "amount": "500000000000000000",
                          "symbol": "ETH",
                          "decimals": 18,
                          "price_usd": 3896.8315,
                          "value_usd": 1948.41575
                        }
                      ],
                      "warnings": [
                        {
                          "code": "UNSUPPORTED_CHAIN_IDS",
                          "message": "Some requested chain_ids are not supported. Balances are returned only for supported chains.",
                          "chain_ids": [
                            9999,
                            77777777777
                          ],
                          "docs_url": "https://docs.sim.dune.com/evm/supported-chains"
                        }
                      ],
                      "request_time": "2025-12-16T10:31:08Z",
                      "response_time": "2025-12-16T10:31:08Z"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - Invalid wallet address or invalid query parameter.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceMessageErrorResponse"
                },
                "examples": {
                  "invalidAddress": {
                    "summary": "Invalid address format",
                    "value": {
                      "message": "Failed to parse address"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized - Invalid or missing API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "invalidApiKey": {
                    "value": {
                      "error": "invalid API Key"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate Limit Exceeded - Too many requests.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "rateLimitExceeded": {
                    "value": {
                      "error": "Too many requests. Please contact sales@dune.com to increase your limit."
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceMessageErrorResponse"
                },
                "examples": {
                  "internalError": {
                    "value": {
                      "message": "Internal server error"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Service Unavailable - The balances service is temporarily in a retry state. Retry the request after a short delay.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceMessageErrorResponse"
                },
                "examples": {
                  "serviceUnavailable": {
                    "value": {
                      "message": "Try again later"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/evm/balances/{address}/token/{token_address}": {
      "get": {
        "tags": [
          "evm",
          "balances"
        ],
        "summary": "Get a single token balance for a given address",
        "description": "Returns the balance for a specific token (or native asset) for a wallet on a single specified chain. This sub-endpoint reuses the Balances response format.",
        "operationId": "getEvmSingleTokenBalance",
        "parameters": [
          {
            "name": "address",
            "in": "path",
            "description": "Wallet address to get the token balance for",
            "required": true,
            "schema": {
              "type": "string",
              "format": "address",
              "pattern": "^0x[a-fA-F0-9]{40}$",
              "default": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
            }
          },
          {
            "name": "token_address",
            "in": "path",
            "description": "Token contract address or `native` for the chain's native asset",
            "required": true,
            "schema": {
              "type": "string",
              "format": "address",
              "pattern": "^0x[a-fA-F0-9]{40}$"
            }
          },
          {
            "name": "chain_ids",
            "in": "query",
            "required": true,
            "description": "Filter by chain(s). Accepts numeric chain IDs and/or tags. Provide a single value (e.g. `?chain_ids=1`) or a comma-separated list (e.g. `?chain_ids=1,8543,testnet`). Chain names are not accepted. If omitted, results include balances from chains with the \"default\" tag for the address. See the [Supported Chains Tags](/evm/supported-chains#tags) section.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "metadata",
            "in": "query",
            "description": "A comma separated list of additional metadata fields to include for each token. Supported values: `logo`, `url`, `pools`",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "historical_prices",
            "in": "query",
            "description": "Historical price selection. Provide a single integer or a comma-separated list of up to 3 integers representing hours in the past (e.g. `168` for 1 week ago or `720,168,24` for 1 month, 1 week, and 1 day ago). When set, each balance includes a historical_prices array with one entry per offset.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "examples": {
              "single_offset": {
                "summary": "Single offset (1 week ago)",
                "value": "168"
              },
              "three_offsets": {
                "summary": "Three offsets (1 month, 1 week, 1 day ago)",
                "value": "720,168,24"
              }
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SingleBalanceResponse"
                },
                "examples": {
                  "success": {
                    "value": {
                      "request_time": "2025-10-07T13:18:14.789152386+00:00",
                      "response_time": "2025-10-07T13:18:14.850098525+00:00",
                      "wallet_address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
                      "balances": [
                        {
                          "chain": "ethereum",
                          "chain_id": 1,
                          "address": "0x146523e8db6337291243a63a5555f446fa6c279f",
                          "amount": "7156868995423049840501842481",
                          "symbol": "AiMeme",
                          "name": "Ai Meme",
                          "decimals": 18,
                          "price_usd": 129086.448055109,
                          "value_usd": 923854797814899,
                          "pool_size": 9.09741149400001,
                          "low_liquidity": true
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - Invalid wallet address or invalid query parameter.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceMessageErrorResponse"
                },
                "examples": {
                  "invalidAddress": {
                    "summary": "Invalid address format",
                    "value": {
                      "message": "Failed to parse address"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized - Invalid or missing API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "invalidApiKey": {
                    "value": {
                      "error": "invalid API Key"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate Limit Exceeded - Too many requests.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "rateLimitExceeded": {
                    "value": {
                      "error": "Too many requests. Please contact sales@dune.com to increase your limit."
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceMessageErrorResponse"
                },
                "examples": {
                  "internalError": {
                    "value": {
                      "message": "Internal server error"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Service Unavailable - The balances service is temporarily in a retry state. Retry the request after a short delay.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceMessageErrorResponse"
                },
                "examples": {
                  "serviceUnavailable": {
                    "value": {
                      "message": "Try again later"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/evm/collectibles/{address}": {
      "get": {
        "summary": "Get EVM Collectibles",
        "description": "Retrieves a list of EVM compatible collectibles (NFTs) for a given wallet address.",
        "operationId": "getEvmCollectibles",
        "tags": [
          "evm",
          "collectibles"
        ],
        "parameters": [
          {
            "name": "address",
            "in": "path",
            "required": true,
            "description": "The wallet address to get collectibles for.",
            "schema": {
              "type": "string",
              "format": "address",
              "pattern": "^0x[a-fA-F0-9]{40}$",
              "default": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
            },
            "example": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
          },
          {
            "name": "chain_ids",
            "in": "query",
            "required": false,
            "description": "Filter by chain(s). Accepts numeric chain IDs and/or tags. Provide a single value (e.g. `?chain_ids=1` or `?chain_ids=mainnet`) or a comma-separated list (e.g. `?chain_ids=1,8543,testnet`). Chain names are not accepted. If this query parameter is omitted, results include collectibles from chains with the `default` tag. See the [Supported Chains Tags](/evm/supported-chains#tags) section.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Pagination cursor. Use the `next_offset` value from the previous response to get the next page. Omit to fetch the first page.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum entries per page for collectibles. Default is 250 when not provided. Values above 2500 are reduced to 2500. If fewer entries exist than the limit, only the available entries are returned.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 2500,
              "default": 250
            }
          },
          {
            "name": "filter_spam",
            "in": "query",
            "required": false,
            "description": "When true, hide collectibles identified as spam. Set to false to return all collectibles, including potential spam. See the [Spam Filtering](#spam-filtering) section for more details.",
            "schema": {
              "type": "boolean",
              "default": true
            }
          },
          {
            "name": "show_spam_scores",
            "in": "query",
            "required": false,
            "description": "When true, include spam scoring details (`spam_score` and `explanations`) to explain filtering decisions.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A list of collectibles for the specified address.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CollectiblesResponse"
                },
                "examples": {
                  "success": {
                    "value": {
                      "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
                      "entries": [
                        {
                          "contract_address": "0x5d28dcf2fbbd3738c0ebe9de03eafcb4ec33015d",
                          "token_standard": "ERC1155",
                          "token_id": "1",
                          "chain": "ethereum",
                          "chain_id": 1,
                          "name": "Beeplfg",
                          "description": "Beeplfg",
                          "symbol": "CRAP",
                          "image_url": "https://api.sim.dune.com/v1/evm/collectible/image/1/0x5d28dcf2fbbd3738c0ebe9de03eafcb4ec33015d/1",
                          "last_sale_price": "0",
                          "metadata": {
                            "uri": "ipfs://QmcnkkMnfL7fugsyrZPEZhPGciLMoo9kwWt1cg4QHLLx3w/0",
                            "attributes": [
                              {
                                "key": "Color",
                                "value": "255, 43, 163"
                              },
                              {
                                "key": "Stance",
                                "value": "Greased"
                              }
                            ]
                          },
                          "is_spam": false,
                          "spam_score": 0,
                          "explanations": [
                            {
                              "feature": "trade_volume",
                              "value": 518,
                              "feature_score": 0,
                              "feature_weight": 0.25
                            },
                            {
                              "feature": "unique_buyers",
                              "value": 145,
                              "feature_score": 0,
                              "feature_weight": 0.25
                            },
                            {
                              "feature": "unique_sellers",
                              "value": 167,
                              "feature_score": 0,
                              "feature_weight": 0.25
                            },
                            {
                              "feature": "externally_flagged",
                              "value": false,
                              "feature_score": 0,
                              "feature_weight": 0.25
                            }
                          ],
                          "balance": "8",
                          "last_acquired": "2025-08-10T03:58:59Z"
                        },
                        {
                          "contract_address": "0x344299dd2af8f81246dcb7b3368c6b9b5ddad4f6",
                          "token_standard": "ERC1155",
                          "token_id": "1",
                          "chain": "bnb",
                          "chain_id": 56,
                          "name": "launchspx org",
                          "balance": "1",
                          "last_acquired": "2025-08-11T04:22:52Z",
                          "is_spam": false
                        },
                        {
                          "contract_address": "0x3c020f2124b84bd079985c77f93d4a750512448c",
                          "token_standard": "ERC721",
                          "token_id": "5132",
                          "chain": "ethereum",
                          "chain_id": 1,
                          "name": "Ethereum Puppet #5132",
                          "description": "Ethereum Puppet #5132",
                          "symbol": "PUPPET",
                          "image_url": "https://api.sim.dune.com/v1/evm/collectible/image/1/0x3c020f2124b84bd079985c77f93d4a750512448c/5132",
                          "last_sale_price": "0.00005",
                          "metadata": {
                            "uri": "https://www.ethereumpuppets.com/metadata/5132",
                            "attributes": [
                              {
                                "key": "Background",
                                "value": "Mustard"
                              },
                              {
                                "key": "Shirt",
                                "value": "Gambler"
                              }
                            ]
                          },
                          "balance": "1",
                          "last_acquired": "2025-08-09T23:07:47Z",
                          "is_spam": false
                        },
                        {
                          "contract_address": "0xa18cf489cf710759f13ac6c8596823dba85354e2",
                          "token_standard": "ERC721",
                          "token_id": "24",
                          "chain": "optimism",
                          "chain_id": 10,
                          "balance": "1",
                          "last_acquired": "2025-08-07T14:51:57Z",
                          "is_spam": false
                        }
                      ],
                      "next_offset": "opaque-pagination-token",
                      "request_time": "2025-08-13T09:40:53Z",
                      "response_time": "2025-08-13T09:40:53Z"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - Invalid address or validation error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Collectibles_ErrorResponse"
                },
                "examples": {
                  "badRequest": {
                    "value": {
                      "error": "Invalid address format"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized - Invalid or missing API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "unauthorized": {
                    "value": {
                      "error": "invalid API Key"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not Found - The requested chain is not supported.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Collectibles_ErrorResponse"
                },
                "examples": {
                  "chainNotSupported": {
                    "value": {
                      "error": "Chain not supported: 999999"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate Limit Exceeded - Too many requests.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "rateLimitExceeded": {
                    "value": {
                      "error": "Too many requests. Please contact sales@dune.com to increase your limit."
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Collectibles_ErrorResponse"
                },
                "examples": {
                  "internalServerError": {
                    "value": {
                      "error": "Failed to bootstrap"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/beta/evm/defi/positions/{address}": {
      "get": {
        "tags": [
          "evm",
          "defi"
        ],
        "summary": "Get DeFi positions for an address",
        "description": "Returns a wallet's DeFi positions including USD values, position-specific metadata, and aggregation summaries across supported protocols.",
        "operationId": "getEvmDefiPositions",
        "parameters": [
          {
            "name": "address",
            "in": "path",
            "description": "Wallet address to inspect for DeFi positions.",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[a-fA-F0-9]{40}$"
            },
            "example": "0x9512044bc14267a6c588296a20bd7c00e0de7da3"
          },
          {
            "name": "chain_ids",
            "in": "query",
            "required": false,
            "description": "Filter by chain(s). Accepts numeric chain IDs and/or tags. Provide a single value (e.g. `?chain_ids=1` or `?chain_ids=mainnet`) or a comma-separated list (e.g. `?chain_ids=1,8453,testnet`). Chain names are not accepted. If this query parameter is omitted, results include positions from chains with the `default` tag. See the [Supported Chains Tags](/evm/supported-chains#tags) section.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DefiPositionsResponse"
                },
                "examples": {
                  "success": {
                    "value": {
                      "positions": [
                        {
                          "type": "Erc4626",
                          "chain_id": 1,
                          "token": "0xdcd0f5ab30856f28385f641580bbd85f88349124",
                          "token_name": "Autonomous Liquidity USD",
                          "token_symbol": "alUSD",
                          "underlying_token": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
                          "underlying_token_name": "USD Coin",
                          "underlying_token_symbol": "USDC",
                          "underlying_token_decimals": 6,
                          "calculated_balance": 0.0673736869415349,
                          "price_in_usd": 0,
                          "usd_value": 0,
                          "logo": "https://api.sim.dune.com/beta/token/logo/1/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
                        },
                        {
                          "type": "Tokenized",
                          "chain_id": 1,
                          "token_type": "AtokenV2",
                          "token": "0x030ba81f1c18d280636f32af80b9aad02cf0854e",
                          "token_name": "Aave interest bearing WETH",
                          "token_symbol": "aWETH",
                          "calculated_balance": 0.0496171604159423,
                          "price_in_usd": 1.03911373514321,
                          "usd_value": 0.0515578728870095,
                          "logo": "https://api.sim.dune.com/beta/token/logo/1/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
                        },
                        {
                          "type": "Tokenized",
                          "chain_id": 1,
                          "token_type": "AtokenV2",
                          "token": "0x9ff58f4ffb29fa2266ab25e75e2a8b3503311656",
                          "token_name": "Aave interest bearing WBTC",
                          "token_symbol": "aWBTC",
                          "calculated_balance": 7.234e-05,
                          "price_in_usd": 29.6320132187639,
                          "usd_value": 0.00214357983624538,
                          "logo": "https://api.sim.dune.com/beta/token/logo/1/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
                        },
                        {
                          "type": "UniswapV2",
                          "chain_id": 1,
                          "protocol": "UniswapV2",
                          "pool": "0x09c29277d081a1b347f41277ff53116a30d4ddff",
                          "token0": "0x4206975c6d7135ad73129476ebe2b06e42f41f50",
                          "token0_name": "FWOG",
                          "token0_symbol": "FWOG",
                          "token0_decimals": 18,
                          "token1": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                          "token1_name": "Wrapped Ether",
                          "token1_symbol": "WETH",
                          "token1_decimals": 18,
                          "lp_balance": "0xca7455529bd53680000",
                          "token0_price": 3.981792910653e-11,
                          "token1_price": 3553.20946160682,
                          "calculated_balance": 59754,
                          "price_in_usd": 0.000802696996635525,
                          "usd_value": 47.9643563369592,
                          "logo": null
                        },
                        {
                          "type": "UniswapV2",
                          "chain_id": 1,
                          "protocol": "UniswapV2",
                          "pool": "0x2c793e52d3180ce2f97ed050428d6ed8473285ee",
                          "token0": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                          "token0_name": "Wrapped Ether",
                          "token0_symbol": "WETH",
                          "token0_decimals": 18,
                          "token1": "0xeb1d4fa4ec26392a1da1344ed1a0b6f8476265b3",
                          "token1_name": "Thailand",
                          "token1_symbol": "THAILAND",
                          "token1_decimals": 18,
                          "lp_balance": "0x141c5f09864c3968",
                          "token0_price": 3553.20946160682,
                          "token1_price": 6.93033022151853e-07,
                          "calculated_balance": 1.44913767461894,
                          "price_in_usd": 0.0993233873678346,
                          "usd_value": 0.1439332626055,
                          "logo": "https://api.sim.dune.com/beta/token/logo/1/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
                        },
                        {
                          "type": "UniswapV2",
                          "chain_id": 1,
                          "protocol": "UniswapV2",
                          "pool": "0x3b0ad93e52a232d8d41e13289976895c295e5b97",
                          "token0": "0x56c18a87b4ee72317e059bd568005a6355b66b01",
                          "token0_name": "Ethereum Army",
                          "token0_symbol": "EthereumArmy",
                          "token0_decimals": 9,
                          "token1": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                          "token1_name": "Wrapped Ether",
                          "token1_symbol": "WETH",
                          "token1_decimals": 18,
                          "lp_balance": "0xf7436a7c1ea8ae82",
                          "token0_price": 6.71694037048083e-09,
                          "token1_price": 3553.20946160682,
                          "calculated_balance": 17.8172016321307,
                          "price_in_usd": 310.047164921547,
                          "usd_value": 5524.17285287768,
                          "logo": null
                        },
                        {
                          "type": "UniswapV2",
                          "chain_id": 1,
                          "protocol": "UniswapV2",
                          "pool": "0x3d1cb7638d73657f7e554eda1d97703bc29d3c15",
                          "token0": "0xa585cb4e6e833d6fa55a992e75b9ee0743b23d69",
                          "token0_name": "Tokenswim",
                          "token0_symbol": "TKS",
                          "token0_decimals": 8,
                          "token1": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                          "token1_name": "Wrapped Ether",
                          "token1_symbol": "WETH",
                          "token1_decimals": 18,
                          "lp_balance": "0x425eb51b908b",
                          "token0_price": 1.20461416147608,
                          "token1_price": 3553.20946160682,
                          "calculated_balance": 7.2974532841611e-05,
                          "price_in_usd": 13300248.4891253,
                          "usd_value": 970.579420171264,
                          "logo": null
                        },
                        {
                          "type": "UniswapV2",
                          "chain_id": 1,
                          "protocol": "UniswapV2",
                          "pool": "0x3d22ea9eb7d7be6d9c6da7542ae17e24a56c9948",
                          "token0": "0x44ac993fcd34a55bcce736ee709a0b1f590327f1",
                          "token0_name": "Made In United States of America",
                          "token0_symbol": "MIUSA",
                          "token0_decimals": 18,
                          "token1": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                          "token1_name": "Wrapped Ether",
                          "token1_symbol": "WETH",
                          "token1_decimals": 18,
                          "lp_balance": "0x9b6e64a8ec60000",
                          "token0_price": 0.000170221012856972,
                          "token1_price": 3553.20946160682,
                          "calculated_balance": 0.7,
                          "price_in_usd": 1.55542454856754,
                          "usd_value": 1.08879718399728,
                          "logo": null
                        },
                        {
                          "type": "UniswapV2",
                          "chain_id": 1,
                          "protocol": "UniswapV2",
                          "pool": "0x4fa956284f1214e7f619a05054ea3b8d4370d225",
                          "token0": "0xb005aac185a963c9ad52ecede60ddaea83417b37",
                          "token0_name": "Edoge",
                          "token0_symbol": "EDOGE",
                          "token0_decimals": 9,
                          "token1": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                          "token1_name": "Wrapped Ether",
                          "token1_symbol": "WETH",
                          "token1_decimals": 18,
                          "lp_balance": "0x1bc16d674ec80000",
                          "token0_price": 7.73273307706922e-09,
                          "token1_price": 3553.20946160682,
                          "calculated_balance": 2,
                          "price_in_usd": 337.500909089399,
                          "usd_value": 675.001818178797,
                          "logo": null
                        },
                        {
                          "type": "UniswapV2",
                          "chain_id": 1,
                          "protocol": "UniswapV2",
                          "pool": "0x60da3e999b92ad9ac0749bdb7f7bc4a84b7654b0",
                          "token0": "0x7e9e98e12e6aa8a2b457b78613f075bd4cbbd4b1",
                          "token0_name": "Pepe Vitalik",
                          "token0_symbol": "PITALIK",
                          "token0_decimals": 9,
                          "token1": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                          "token1_name": "Wrapped Ether",
                          "token1_symbol": "WETH",
                          "token1_decimals": 18,
                          "lp_balance": "0x2386f26fc100000",
                          "token0_price": 5.223622125649e-05,
                          "token1_price": 3553.20946160682,
                          "calculated_balance": 0.16,
                          "price_in_usd": 27834.7019989285,
                          "usd_value": 4453.55231982856,
                          "logo": null
                        },
                        {
                          "type": "UniswapV2",
                          "chain_id": 1,
                          "protocol": "UniswapV2",
                          "pool": "0x85e25bc853a5cf2265dc9d04e2fbbfd32a95a7e5",
                          "token0": "0x31448ab1bd9679f8c8029defee824763018566bd",
                          "token0_name": "MEOW",
                          "token0_symbol": "Vitalik Learn to Meow",
                          "token0_decimals": 18,
                          "token1": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                          "token1_name": "Wrapped Ether",
                          "token1_symbol": "WETH",
                          "token1_decimals": 18,
                          "lp_balance": "0x66845b21facdd560fe31a",
                          "token0_price": 5.36553654627e-12,
                          "token1_price": 3553.20946160682,
                          "calculated_balance": 7745966.69241483,
                          "price_in_usd": 0.000276152558547498,
                          "usd_value": 2139.06852053406,
                          "logo": null
                        },
                        {
                          "type": "UniswapV2",
                          "chain_id": 1,
                          "protocol": "UniswapV2",
                          "pool": "0x87ffcda0c507117683f0bc0defb683eebe9c223b",
                          "token0": "0x693391144d1e079e20cc64f795e9450c94966171",
                          "token0_name": "Layer 2 Index",
                          "token0_symbol": "LTI",
                          "token0_decimals": 18,
                          "token1": "0x6b175474e89094c44da98b954eedeac495271d0f",
                          "token1_name": "Dai Stablecoin",
                          "token1_symbol": "DAI",
                          "token1_decimals": 18,
                          "lp_balance": "0x8ac7230489e80000",
                          "token0_price": 0.362412002420127,
                          "token1_price": 0.998865563776363,
                          "calculated_balance": 10,
                          "price_in_usd": 1.2092122125549,
                          "usd_value": 12.092122125549,
                          "logo": null
                        },
                        {
                          "type": "UniswapV2",
                          "chain_id": 1,
                          "protocol": "UniswapV2",
                          "pool": "0xa7f8de1f0e6964201d412fd172e5740663b35567",
                          "token0": "0x8df994371e3cfe3d218d2b8f42b5bf414651fcd8",
                          "token0_name": "FLOKI SANTA",
                          "token0_symbol": "FLOKIS",
                          "token0_decimals": 18,
                          "token1": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                          "token1_name": "Wrapped Ether",
                          "token1_symbol": "WETH",
                          "token1_decimals": 18,
                          "lp_balance": "0x3eb908bfa9242f200000",
                          "token0_price": 5.410934490399e-10,
                          "token1_price": 3553.20946160682,
                          "calculated_balance": 296200,
                          "price_in_usd": 0.0027889628548969,
                          "usd_value": 826.090797620462,
                          "logo": null
                        },
                        {
                          "type": "Nft",
                          "chain_id": 8453,
                          "protocol": "UniswapV3",
                          "pool": "0x7a0640ca0c8b07789edaaefda82bf5790109aa44",
                          "token0": "0x07449b62ec61f12d6110c36db240436222b02530",
                          "token0_name": "DOGE",
                          "token0_symbol": "DOGE",
                          "token0_decimals": 18,
                          "token1": "0x4200000000000000000000000000000000000006",
                          "token1_name": "Wrapped Ether",
                          "token1_symbol": "WETH",
                          "token1_decimals": 18,
                          "positions": [
                            {
                              "tick_lower": -887272,
                              "tick_upper": 887272,
                              "token_id": "0x132c81",
                              "token0_price": 9.48452516697798e-07,
                              "token0_holdings": 613763253.0586,
                              "token0_rewards": 21676.3984019538,
                              "token1_price": 3570.25944039075,
                              "token1_holdings": 0.162913339628563,
                              "token1_rewards": 1.0452682406464e-05
                            }
                          ],
                          "logo": null,
                          "usd_value": 1163.82606861717
                        },
                        {
                          "type": "Nft",
                          "chain_id": 1,
                          "protocol": "UniswapV3",
                          "pool": "0x7625d7f67e4e44341ddfb1e698801fd5a1574b48",
                          "token0": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                          "token0_name": "Wrapped Ether",
                          "token0_symbol": "WETH",
                          "token0_decimals": 18,
                          "token1": "0xd78959df1ff28b45e6b4ea234bdcf9d6609d16e1",
                          "token1_name": "Moneda de Caca",
                          "token1_symbol": "Mierda",
                          "token1_decimals": 18,
                          "positions": [
                            {
                              "tick_lower": 0,
                              "tick_upper": 184200,
                              "token_id": "0xe8ac0",
                              "token0_price": 3553.20946160682,
                              "token0_holdings": 0,
                              "token0_rewards": 0.000201014351146556,
                              "token1_price": 0,
                              "token1_holdings": 100000000,
                              "token1_rewards": 19678.323702556
                            }
                          ],
                          "logo": "https://api.sim.dune.com/beta/token/logo/1/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                          "usd_value": 0.714246094412699
                        },
                        {
                          "type": "Nft",
                          "chain_id": 8453,
                          "protocol": "UniswapV3",
                          "pool": "0xf3b058e81ac53c475cf6e9d12724e3493fd8ffe7",
                          "token0": "0x2ef9f33ae8f8e7f7858ed24965b04ec8fc4e5841",
                          "token0_name": "Numbers",
                          "token0_symbol": "NMB404",
                          "token0_decimals": 18,
                          "token1": "0x4200000000000000000000000000000000000006",
                          "token1_name": "Wrapped Ether",
                          "token1_symbol": "WETH",
                          "token1_decimals": 18,
                          "positions": [
                            {
                              "tick_lower": -39000,
                              "tick_upper": 887200,
                              "token_id": "0xb3e4",
                              "token0_price": 93.9873376113841,
                              "token0_holdings": 38.7920703525764,
                              "token0_rewards": 0.808474625304572,
                              "token1_price": 3570.25944039075,
                              "token1_holdings": 0.145798328127171,
                              "token1_rewards": 0.171277142433281
                            }
                          ],
                          "logo": null,
                          "usd_value": 4853.9914825157
                        },
                        {
                          "type": "Nft",
                          "chain_id": 1,
                          "protocol": "UniswapV3",
                          "pool": "0x24a3ab2a20f5e903b5bb3efc3b4a60fcda17b496",
                          "token0": "0x6793655c396eaee311fb4d3596b88fd7d195c79e",
                          "token0_name": "degeneratorv2",
                          "token0_symbol": "DGENV2",
                          "token0_decimals": 8,
                          "token1": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                          "token1_name": "Wrapped Ether",
                          "token1_symbol": "WETH",
                          "token1_decimals": 18,
                          "positions": [
                            {
                              "tick_lower": -887270,
                              "tick_upper": 230270,
                              "token_id": "0x1b621",
                              "token0_price": 0.0719515070037307,
                              "token0_holdings": 3047.05602573,
                              "token0_rewards": 5.63917856,
                              "token1_price": 3553.20946160682,
                              "token1_holdings": 0.0616595719741519,
                              "token1_rewards": 0.0319835526435363
                            }
                          ],
                          "logo": null,
                          "usd_value": 552.379656777724
                        },
                        {
                          "type": "NftV4",
                          "chain_id": 1,
                          "protocol": "UniswapV4",
                          "pool_id": [
                            33,
                            251,
                            41,
                            59,
                            157,
                            197,
                            59,
                            66,
                            250,
                            110,
                            99,
                            250,
                            36,
                            225,
                            33,
                            45,
                            231,
                            108,
                            136,
                            235,
                            122,
                            21,
                            185,
                            76,
                            210,
                            32,
                            252,
                            102,
                            39,
                            72,
                            81,
                            191
                          ],
                          "pool_manager": "0x000000000004444c5dc75cb358380d2e3de08a90",
                          "salt": [
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            0,
                            33,
                            24
                          ],
                          "token0": "0x0000000000000000000000000000000000000000",
                          "token0_name": "Ether",
                          "token0_symbol": "ETH",
                          "token0_decimals": 18,
                          "token1": "0xf9c8631fba291bac14ed549a2dde7c7f2ddff1a8",
                          "token1_name": "Mighty Morphin Power Rangers",
                          "token1_symbol": "GoGo",
                          "token1_decimals": 18,
                          "positions": [
                            {
                              "tick_lower": -184220,
                              "tick_upper": 207220,
                              "token_id": "0x2118",
                              "token0_price": 3553.20946160682,
                              "token0_holdings": 4.7749999999999e-05,
                              "token0_rewards": 8.749999999999e-06,
                              "token1_price": 3.581798534713e-06,
                              "token1_holdings": 479952364.515627,
                              "token1_rewards": 8399.79998597393
                            }
                          ],
                          "logo": "https://api.sim.dune.com/beta/token/logo/1/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                          "usd_value": 1719.32351868043
                        }
                      ],
                      "aggregations": {
                        "total_usd_value": 22940.0436122581,
                        "total_by_chain": {
                          "1": 16922.2260611252,
                          "8453": 6017.81755113287
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - Invalid user address.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Collectibles_ErrorResponse"
                },
                "examples": {
                  "invalidAddress": {
                    "value": {
                      "error": "Invalid user address"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized - Invalid or missing API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "invalidApiKey": {
                    "value": {
                      "error": "invalid API Key"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate Limit Exceeded - Too many requests.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "rateLimitExceeded": {
                    "value": {
                      "error": "Too many requests. Please contact sales@dune.com to increase your limit."
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Collectibles_ErrorResponse"
                },
                "examples": {
                  "internalError": {
                    "value": {
                      "error": "Internal error: unexpected failure"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/evm/balances/{address}/stablecoins": {
      "get": {
        "tags": [
          "evm",
          "balances"
        ],
        "summary": "Get stablecoin balances for a given address",
        "description": "This endpoint returns stablecoin balances for an address across supported EVM chains. It filters the standard balances response to include only configured stablecoins (USD-pegged, yield-bearing, and euro-pegged).",
        "operationId": "getEvmStablecoinBalances",
        "parameters": [
          {
            "name": "address",
            "in": "path",
            "description": "Wallet address to get stablecoin balances for",
            "required": true,
            "schema": {
              "type": "string",
              "format": "address",
              "pattern": "^0x[a-fA-F0-9]{40}$",
              "default": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
            }
          },
          {
            "name": "chain_ids",
            "in": "query",
            "required": false,
            "description": "Filter by chain(s). Accepts numeric chain IDs and/or tags. Provide a single value (e.g. `?chain_ids=1` or `?chain_ids=mainnet`) or a comma-separated list (e.g. `?chain_ids=1,8453,137`). If omitted, results include balances from chains with the `default` tag. See the [Supported Chains Tags](/evm/supported-chains#tags) section.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filters",
            "in": "query",
            "description": "Specify `erc20` or `native` to get only ERC20 stablecoins or native stablecoins (e.g., xDAI on Gnosis), respectively",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "erc20",
                "native"
              ]
            }
          },
          {
            "name": "metadata",
            "in": "query",
            "description": "A comma separated list of additional metadata fields to include for each token. Supported values: `logo`, `url`, `pools`",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "exclude_spam_tokens",
            "in": "query",
            "description": "When true, excludes tokens with less than 100 USD liquidity from the response. This differs from the `low_liquidity` field in the response.",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "historical_prices",
            "in": "query",
            "description": "Historical price selection. Provide a single integer or a comma-separated list of up to 3 integers representing hours in the past (e.g. `168` for 1 week ago or `720,168,24` for 1 month, 1 week, and 1 day ago). When set, each balance includes a historical_prices array with one entry per offset.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "examples": {
              "single_offset": {
                "summary": "Single offset (1 week ago)",
                "value": "168"
              },
              "three_offsets": {
                "summary": "Three offsets (1 month, 1 week, 1 day ago)",
                "value": "720,168,24"
              }
            }
          },
          {
            "name": "offset",
            "in": "query",
            "description": "The offset to paginate through result sets. This is a cursor being passed from the previous response, only use what the backend returns here.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of balances to return. Default is 1000 when not provided. Values above 1000 are reduced to 1000.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 1000,
              "default": 1000
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StablecoinBalancesResponse"
                },
                "examples": {
                  "success": {
                    "value": {
                      "wallet_address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
                      "balances": [
                        {
                          "chain": "ethereum",
                          "chain_id": 1,
                          "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
                          "amount": "1000000000",
                          "symbol": "USDC",
                          "name": "USD Coin",
                          "decimals": 6,
                          "price_usd": 1,
                          "value_usd": 1000
                        },
                        {
                          "chain": "base",
                          "chain_id": 8453,
                          "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
                          "amount": "500000000",
                          "symbol": "USDC",
                          "name": "USD Coin",
                          "decimals": 6,
                          "price_usd": 1,
                          "value_usd": 500
                        },
                        {
                          "chain": "gnosis",
                          "chain_id": 100,
                          "address": "native",
                          "amount": "100000000000000000000",
                          "symbol": "XDAI",
                          "decimals": 18,
                          "price_usd": 1,
                          "value_usd": 100
                        }
                      ],
                      "next_offset": "opaque-pagination-token",
                      "request_time": "2026-02-05T10:31:08Z",
                      "response_time": "2026-02-05T10:31:08Z"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - Invalid wallet address or invalid query parameter.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceMessageErrorResponse"
                },
                "examples": {
                  "invalidAddress": {
                    "summary": "Invalid address format",
                    "value": {
                      "message": "Failed to parse address"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized - Invalid or missing API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "invalidApiKey": {
                    "value": {
                      "error": "invalid API Key"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate Limit Exceeded - Too many requests.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "rateLimitExceeded": {
                    "value": {
                      "error": "Too many requests. Please contact sales@dune.com to increase your limit."
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceMessageErrorResponse"
                },
                "examples": {
                  "internalError": {
                    "value": {
                      "message": "Internal server error"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Service Unavailable - The balances service is temporarily in a retry state. Retry the request after a short delay.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceMessageErrorResponse"
                },
                "examples": {
                  "serviceUnavailable": {
                    "value": {
                      "message": "Try again later"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/evm/supported-chains": {
      "get": {
        "tags": [
          "evm",
          "supported-chains"
        ],
        "summary": "Get a list of supported chains for EVM endpoints",
        "description": "This endpoint returns a list of chains that are supported by the EVM endpoints. This is a unified endpoint that replaces the individual chains endpoints for each service.",
        "operationId": "getEvmSupportedChains",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChainsResponse"
                },
                "example": {
                  "chains": [
                    {
                      "id": 42161,
                      "name": "arbitrum",
                      "supported_assets": [
                        "native",
                        "erc20"
                      ],
                      "tags": [
                        "default",
                        "mainnet"
                      ]
                    },
                    {
                      "id": 1,
                      "name": "ethereum",
                      "supported_assets": [
                        "native",
                        "erc20"
                      ],
                      "tags": [
                        "default",
                        "mainnet"
                      ]
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - The request could not be understood by the server due to malformed data"
          },
          "404": {
            "description": "Not Found"
          },
          "429": {
            "description": "Rate Limit Exceeded - Too many requests.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "rateLimitExceeded": {
                    "value": {
                      "error": "Too many requests. Please contact sales@dune.com to increase your limit."
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error - A generic error occurred on the server"
          }
        }
      }
    },
    "/v1/evm/token-holders/{chain_id}/{address}": {
      "get": {
        "summary": "Get Token Holders",
        "description": "Retrieves a list of token holders for a given token contract address on a specified blockchain.",
        "operationId": "getTokenHolders",
        "tags": [
          "evm",
          "token-holders"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "The chain id of the blockchain (e.g., 8453 for Base). For a full list see [Supported Chains](/evm/supported-chains).",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 8453
            },
            "example": 8453
          },
          {
            "name": "address",
            "in": "path",
            "required": true,
            "description": "The token contract address.",
            "schema": {
              "type": "string",
              "format": "address",
              "pattern": "^0x[a-fA-F0-9]{40}$",
              "default": "0x63706e401c06ac8513145b7687A14804d17f814b"
            },
            "example": "0x63706e401c06ac8513145b7687A14804d17f814b"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of token holders to return. Default is 500 when not provided. Values above 500 are reduced to 500.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1,
              "maximum": 500,
              "default": 500
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Pagination token from the previous response's next_offset field.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A list of token holders for the specified token address on the specified chain.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TokenHoldersResponse"
                },
                "examples": {
                  "success": {
                    "value": {
                      "token_address": "0x63706e401c06ac8513145b7687a14804d17f814b",
                      "chain_id": 8453,
                      "holders": [
                        {
                          "wallet_address": "0x4a79b0168296c0ef7b8f314973b82ad406a29f1b",
                          "balance": "13794442047246482254818",
                          "first_acquired": "2025-02-06T15:11:07+00:00",
                          "has_initiated_transfer": false
                        },
                        {
                          "wallet_address": "0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B",
                          "balance": "25000000000000000000",
                          "first_acquired": "2024-01-15T10:30:00+00:00",
                          "has_initiated_transfer": true
                        }
                      ],
                      "next_offset": "eyJwYWdlIjoyLCJsaW1pdCI6Mn0="
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - Malformed request.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TokenHolders_ErrorResponse"
                },
                "examples": {
                  "badRequest": {
                    "value": {
                      "error": {
                        "message": "Verify the address format and other parameters in your request",
                        "code": "BAD_REQUEST"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized - Invalid or missing API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "invalidApiKey": {
                    "value": {
                      "error": "invalid API Key"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not Found - Resource not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TokenHolders_ErrorResponse"
                },
                "examples": {
                  "notFound": {
                    "value": {
                      "error": {
                        "message": "Resource not found",
                        "code": "NOT_FOUND"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate Limit Exceeded - Too many requests.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "rateLimitExceeded": {
                    "value": {
                      "error": "Too many requests. Please contact sales@dune.com to increase your limit."
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error - Server-side error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TokenHolders_ErrorResponse"
                },
                "examples": {
                  "internalServerError": {
                    "value": {
                      "error": {
                        "message": "Server-side error",
                        "code": "INTERNAL_SERVER_ERROR"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/evm/token-info/{address}": {
      "get": {
        "tags": [
          "evm",
          "token-info"
        ],
        "summary": "Get EVM token information for a specified contract address (or the native token), on any chain.",
        "operationId": "getEvmTokenInfo",
        "parameters": [
          {
            "name": "address",
            "in": "path",
            "description": "The contract address of the token or 'native' for the native token of the chain",
            "required": true,
            "schema": {
              "type": "string",
              "format": "address",
              "pattern": "^0x[a-fA-F0-9]{40}$",
              "default": "0xd9aaec86b65d86f6a7b5b1b0c42ffa531710b6ca"
            },
            "example": "0xd9aaec86b65d86f6a7b5b1b0c42ffa531710b6ca"
          },
          {
            "name": "chain_ids",
            "in": "query",
            "description": "Specify exactly one chain. Accepts a single numeric chain ID (e.g. `?chain_ids=1`). Chain names are not accepted. See the [Supported Chains Tags](/evm/supported-chains#tags) section.",
            "required": true,
            "schema": {
              "type": "string",
              "default": "8453"
            },
            "example": "8453"
          },
          {
            "name": "historical_prices",
            "in": "query",
            "description": "Request historical point-in-time prices. Provide a single integer or a comma-separated list of up to 3 integers representing hours in the past (e.g. `168` for 1 week ago or `720,168,24` for 1 month, 1 week, and 1 day ago). When present, each token includes a historical_prices array with one entry per offset.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "examples": {
              "single_offset": {
                "summary": "Single offset (1 week ago)",
                "value": "168"
              },
              "three_offsets": {
                "summary": "Three offsets (1 month, 1 week, 1 day ago)",
                "value": "720,168,24"
              }
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "This endpoint returns up to the number of supported chains. See [Supported Chains](/evm/supported-chains) to learn more.",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0
            },
            "example": 100
          },
          {
            "name": "offset",
            "in": "query",
            "description": "The offset to paginate through result sets; this is a cursor being passed from the previous response, only use what the backend returns here",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TokensResponse"
                },
                "example": {
                  "contract_address": "native",
                  "tokens": [
                    {
                      "chain": "ethereum",
                      "chain_id": 1,
                      "price_usd": 12.34,
                      "symbol": "ETH"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - Invalid address, chain ID, token ID, or batch size exceeded.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "examples": {
                  "invalidAddress": {
                    "summary": "Invalid address",
                    "value": "Invalid address: expected a hex-encoded address"
                  },
                  "invalidChainId": {
                    "summary": "Invalid chain ID",
                    "value": "Invalid chain id: 999999"
                  },
                  "batchSizeExceeded": {
                    "summary": "Batch size exceeded",
                    "value": "Batch size exceeds maximum limit of 100 tokens"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized - Invalid or missing API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "invalidApiKey": {
                    "value": {
                      "error": "invalid API Key"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not Found - Token or resource not found.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "examples": {
                  "tokenNotFound": {
                    "summary": "Token not found",
                    "value": "Token not found"
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate Limit Exceeded - Too many requests.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "rateLimitExceeded": {
                    "value": {
                      "error": "Too many requests. Please contact sales@dune.com to increase your limit."
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "examples": {
                  "storeError": {
                    "summary": "Store read failure",
                    "value": "Failed to read from store: connection timeout"
                  }
                }
              }
            }
          }
        },
        "description": "Returns metadata and pricing information for a specific EVM token. Includes token name, symbol, decimals, current price in USD, and optionally historical price data when the `historical_prices` parameter is set."
      }
    },
    "/v1/evm/transactions/{address}": {
      "get": {
        "tags": [
          "evm",
          "transactions"
        ],
        "summary": "Get EVM transactions",
        "description": "Get transactions for a given EVM address",
        "operationId": "getEvmTransactions",
        "parameters": [
          {
            "name": "address",
            "in": "path",
            "description": "EVM wallet address",
            "required": true,
            "schema": {
              "type": "string",
              "format": "address",
              "pattern": "^0x[a-fA-F0-9]{40}$",
              "default": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
            },
            "example": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
          },
          {
            "name": "chain_ids",
            "in": "query",
            "description": "Filter by chain(s). Accepts numeric chain IDs and/or tags. Provide a single value (e.g. `?chain_ids=1` or `?chain_ids=mainnet`) or a comma-separated list (e.g. `?chain_ids=1,8543,testnet`). Chain names are not accepted. If this query parameter is omitted, results include transactions from chains with the `default` tag. See the [Supported Chains Tags](/evm/supported-chains#tags) section.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of results to return. Default is 100 when not provided. Values above 100 are reduced to 100.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 1,
              "maximum": 100,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "description": "The offset to paginate through result sets. This is a cursor being passed from the previous response, only use what the backend returns here.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "decode",
            "in": "query",
            "description": "When true, it includes decoded transaction logs in the response. Accepts only boolean values true or false. You can also omit this parameter to disable decoding. Invalid values will return an error.",
            "required": false,
            "schema": {
              "type": "boolean"
            },
            "example": true
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TransactionsResponse"
                },
                "examples": {
                  "success": {
                    "summary": "Successful response",
                    "value": {
                      "transactions": [
                        {
                          "address": "0x7532cd0651030d3dc80b28199a125fc9f5ac80fa",
                          "block_hash": "0x745bdf699cee1fef27b9304be43a2435c744500ef455cc6b7dfb4c34417601a2",
                          "block_number": "30819446",
                          "block_time": "2025-05-28T10:30:39Z",
                          "chain": "base",
                          "from": "0x7532cd0651030d3dc80b28199a125fc9f5ac80fa",
                          "to": "0x6ff5693b99212da76ad316178a184ab56d299b43",
                          "data": "0x3593564c000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000006836ecce000000000000000000000000000000000000000000000000000000000000000308060c000000000000000000000000000000000000000000000000000000000000",
                          "gas_price": "0x5aaa88",
                          "hash": "0x1081ebf623669338e9de6865d08d7ff3a3d1b0ef6f6486b350c3caf5b2e9257d",
                          "index": "35",
                          "nonce": "0x8",
                          "transaction_type": "0x2",
                          "value": "0x0",
                          "decoded": {
                            "name": "execute",
                            "inputs": [
                              {
                                "name": "_commands",
                                "type": "bytes",
                                "value": "0x08060c"
                              },
                              {
                                "name": "_inputs",
                                "type": "bytes[]",
                                "value": [
                                  "0x000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000186a0"
                                ]
                              },
                              {
                                "name": "_deadline",
                                "type": "uint256",
                                "value": "1748430030"
                              }
                            ]
                          },
                          "logs": [
                            {
                              "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
                              "data": "0x00000000000000000000000000000000000000000000000000000000000186a0",
                              "topics": [
                                "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
                                "0x0000000000000000000000007532cd0651030d3dc80b28199a125fc9f5ac80fa",
                                "0x00000000000000000000000088a43bbdf9d098eec7bceda4e2494615dfd9bb9c"
                              ],
                              "decoded": {
                                "name": "Transfer",
                                "inputs": [
                                  {
                                    "name": "sender",
                                    "type": "address",
                                    "value": "0x7532cd0651030d3dc80b28199a125fc9f5ac80fa"
                                  },
                                  {
                                    "name": "to",
                                    "type": "address",
                                    "value": "0x88a43bbdf9d098eec7bceda4e2494615dfd9bb9c"
                                  },
                                  {
                                    "name": "value",
                                    "type": "uint256",
                                    "value": "100000"
                                  }
                                ]
                              }
                            }
                          ]
                        }
                      ],
                      "next_offset": "QBHrUqbdBQDkBwAAAAAAACHjyAAAAAAAAAAAAAAAAAACAAAAAAAAAA",
                      "request_time": "2025-05-28T10:31:56Z",
                      "response_time": "2025-05-28T10:31:56Z",
                      "wallet_address": "0x7532cd0651030d3dc80b28199a125fc9f5ac80fa"
                    }
                  },
                  "with_warnings": {
                    "summary": "Response with unsupported chain IDs warning",
                    "value": {
                      "transactions": [
                        {
                          "address": "0x37305b1cd40574e4c5ce33f8e8306be057fd7341",
                          "block_hash": "0x745bdf699cee1fef27b9304be43a2435c744500ef455cc6b7dfb4c34417601a2",
                          "block_number": "30819446",
                          "block_time": "2025-05-28T10:30:39Z",
                          "chain": "ethereum",
                          "from": "0x37305b1cd40574e4c5ce33f8e8306be057fd7341",
                          "to": "0x6ff5693b99212da76ad316178a184ab56d299b43",
                          "data": "0x",
                          "gas_price": "0x5aaa88",
                          "hash": "0x1081ebf623669338e9de6865d08d7ff3a3d1b0ef6f6486b350c3caf5b2e9257d",
                          "index": "35",
                          "nonce": "0x8",
                          "transaction_type": "0x2",
                          "value": "0x0",
                          "logs": []
                        }
                      ],
                      "warnings": [
                        {
                          "code": "UNSUPPORTED_CHAIN_IDS",
                          "message": "Some requested chain_ids are not supported. Transactions are returned only for supported chains.",
                          "chain_ids": [
                            9999,
                            77777777777
                          ],
                          "docs_url": "https://docs.sim.dune.com/evm/supported-chains"
                        }
                      ],
                      "next_offset": "QBHrUqbdBQDkBwAAAAAAACHjyAAAAAAAAAAAAAAAAAACAAAAAAAAAA",
                      "request_time": "2025-12-16T10:31:56Z",
                      "response_time": "2025-12-16T10:31:56Z",
                      "wallet_address": "0x37305b1cd40574e4c5ce33f8e8306be057fd7341"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - Invalid wallet address, invalid query parameter, or unknown sort/filter property.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "examples": {
                  "invalidAddress": {
                    "summary": "Invalid address format",
                    "value": "invalid length 39, expected a (both 0x-prefixed or not) hex string or byte array containing 20 bytes"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized - Invalid or missing API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "invalidApiKey": {
                    "value": {
                      "error": "invalid API Key"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate Limit Exceeded - Too many requests.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "rateLimitExceeded": {
                    "value": {
                      "error": "Too many requests. Please contact sales@dune.com to increase your limit."
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "examples": {
                  "internalError": {
                    "summary": "Internal server error",
                    "value": "Internal server error"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/beta/evm/subscriptions/webhooks": {
      "get": {
        "tags": [
          "evm",
          "subscriptions"
        ],
        "summary": "List all webhooks",
        "description": "Returns a list of all webhook subscriptions for the authenticated team.",
        "operationId": "listWebhooks",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "type": "integer",
              "default": 100
            },
            "description": "Number of results to return. Defaults to 100."
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "type": "string"
            },
            "description": "The offset to paginate through result sets; this is a cursor being passed from the previous response."
          }
        ],
        "responses": {
          "200": {
            "description": "A list of webhooks.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebhooksList"
                },
                "example": {
                  "webhooks": [
                    {
                      "id": "019a81c2-d84b-7141-85e8-86b072a59142",
                      "team_id": "01K7RVMRT0BXQ9DRC8BK87MK39",
                      "name": "Balance Changes Monitor",
                      "type": "balances",
                      "url": "https://example.com/webhooks/balances",
                      "active": true,
                      "created_at": "2025-11-14T09:47:01.580104Z",
                      "updated_at": "2025-11-14T09:47:01.580104Z",
                      "chain_ids": [
                        1,
                        8453,
                        84532
                      ],
                      "asset_type": "erc20",
                      "token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
                    },
                    {
                      "id": "019a81c2-e95c-7241-95f9-97c183b6a253",
                      "team_id": "01K7RVMRT0BXQ9DRC8BK87MK39",
                      "name": "Swap Activity Tracker",
                      "type": "activities",
                      "url": "https://example.com/webhooks/activities",
                      "active": true,
                      "created_at": "2025-11-14T10:15:22.123456Z",
                      "updated_at": "2025-11-14T10:15:22.123456Z",
                      "chain_ids": [
                        1,
                        8453
                      ],
                      "activity_type": "swap"
                    },
                    {
                      "id": "019a81c2-f86d-7351-a6fa-a8d294c7b364",
                      "team_id": "01K7RVMRT0BXQ9DRC8BK87MK39",
                      "name": "Incoming Transactions Monitor",
                      "type": "transactions",
                      "url": "https://example.com/webhooks/transactions",
                      "active": true,
                      "created_at": "2025-11-14T10:30:45.789012Z",
                      "updated_at": "2025-11-14T10:30:45.789012Z",
                      "chain_ids": [
                        1
                      ],
                      "transaction_type": "receiver"
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "Rate Limit Exceeded - Too many requests.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "rateLimitExceeded": {
                    "value": {
                      "error": "Too many requests. Please contact sales@dune.com to increase your limit."
                    }
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "evm",
          "subscriptions"
        ],
        "summary": "Create a webhook",
        "description": "Creates a new webhook subscription.",
        "operationId": "createWebhook",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebhook"
              },
              "example": {
                "name": "USDC Balance Monitor",
                "url": "https://example.com/webhooks/usdc-balances",
                "type": "balances",
                "addresses": [
                  "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                ],
                "chain_ids": [
                  1,
                  8453
                ],
                "asset_type": "erc20",
                "token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Webhook created successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Webhook"
                },
                "example": {
                  "id": "019a81c2-d84b-7141-85e8-86b072a59142",
                  "team_id": "01K7RVMRT0BXQ9DRC8BK87MK39",
                  "name": "Balance Changes Tracker",
                  "type": "balances",
                  "url": "https://example.com/webhooks/balances",
                  "active": true,
                  "created_at": "2025-11-14T09:47:01.580104Z",
                  "updated_at": "2025-11-14T09:47:01.580104Z",
                  "chain_ids": [
                    1,
                    8453,
                    84532
                  ]
                }
              }
            }
          },
          "422": {
            "description": "Validation error for request body.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string",
                  "example": "Failed to deserialize the JSON body into the target type: missing field `name` at line 1 column 2"
                }
              }
            }
          },
          "429": {
            "description": "Rate Limit Exceeded - Too many requests.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "rateLimitExceeded": {
                    "value": {
                      "error": "Too many requests. Please contact sales@dune.com to increase your limit."
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/beta/evm/subscriptions/webhooks/{webhookId}": {
      "get": {
        "tags": [
          "evm",
          "subscriptions"
        ],
        "summary": "Get a webhook",
        "description": "Retrieves the details of a specific webhook subscription by its ID.",
        "operationId": "getWebhook",
        "parameters": [
          {
            "name": "webhookId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "description": "The unique identifier of the webhook."
          }
        ],
        "responses": {
          "200": {
            "description": "Webhook details.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Webhook"
                },
                "example": {
                  "id": "019a81c2-d84b-7141-85e8-86b072a59142",
                  "team_id": "01K7RVMRT0BXQ9DRC8BK87MK39",
                  "name": "Balance Changes Tracker",
                  "type": "balances",
                  "url": "https://example.com/webhooks/balances",
                  "active": true,
                  "created_at": "2025-11-14T09:47:01.580104Z",
                  "updated_at": "2025-11-14T09:47:01.580104Z",
                  "chain_ids": [
                    1,
                    8453,
                    84532
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid webhook ID.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "example": "Invalid URL: UUID parsing failed: invalid group length in group 4: expected 12, found 11"
              }
            }
          },
          "429": {
            "description": "Rate Limit Exceeded - Too many requests.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "rateLimitExceeded": {
                    "value": {
                      "error": "Too many requests. Please contact sales@dune.com to increase your limit."
                    }
                  }
                }
              }
            }
          }
        }
      },
      "patch": {
        "tags": [
          "evm",
          "subscriptions"
        ],
        "summary": "Update a webhook",
        "description": "Partially updates a webhook subscription's configuration (name, URL, status, chain filters, etc.). To manage addresses, use the PATCH /webhooks/{webhookId}/addresses endpoint instead.",
        "operationId": "updateWebhook",
        "parameters": [
          {
            "name": "webhookId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "description": "The unique identifier of the webhook."
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateWebhook"
              },
              "examples": {
                "pause_webhook": {
                  "summary": "Pause a webhook",
                  "value": {
                    "active": false
                  }
                },
                "update_url": {
                  "summary": "Update destination URL",
                  "value": {
                    "url": "https://new-endpoint.example.com/webhooks"
                  }
                },
                "update_chains": {
                  "summary": "Change chain filter",
                  "value": {
                    "chain_ids": [
                      1,
                      10,
                      8453
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Webhook updated successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Webhook"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request. This can occur when trying to set properties that are incompatible with the webhook type.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "example": "Webhook type balances cannot have activity_type"
              }
            }
          },
          "429": {
            "description": "Rate Limit Exceeded - Too many requests.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "rateLimitExceeded": {
                    "value": {
                      "error": "Too many requests. Please contact sales@dune.com to increase your limit."
                    }
                  }
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "evm",
          "subscriptions"
        ],
        "summary": "Delete a webhook",
        "description": "Deletes a specific webhook subscription.",
        "operationId": "deleteWebhook",
        "parameters": [
          {
            "name": "webhookId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "description": "The unique identifier of the webhook."
          }
        ],
        "responses": {
          "200": {
            "description": "Webhook deleted successfully. No response body."
          },
          "400": {
            "description": "Invalid webhook ID.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "example": "Invalid URL: UUID parsing failed: invalid group length in group 4: expected 12, found 11"
              }
            }
          },
          "429": {
            "description": "Rate Limit Exceeded - Too many requests.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "rateLimitExceeded": {
                    "value": {
                      "error": "Too many requests. Please contact sales@dune.com to increase your limit."
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/beta/evm/subscriptions/webhooks/{webhookId}/addresses": {
      "get": {
        "tags": [
          "evm",
          "subscriptions"
        ],
        "summary": "Get webhook addresses",
        "description": "Retrieves the list of subscribed addresses for a specific webhook.",
        "operationId": "getWebhookAddresses",
        "parameters": [
          {
            "name": "webhookId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "description": "The unique identifier of the webhook."
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "type": "integer",
              "default": 100
            },
            "description": "Number of results to return. Defaults to 100."
          },
          {
            "in": "query",
            "name": "offset",
            "schema": {
              "type": "string"
            },
            "description": "The offset to paginate through result sets."
          }
        ],
        "responses": {
          "200": {
            "description": "A list of addresses.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AddressesList"
                },
                "example": {
                  "addresses": [
                    "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
                    "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid webhook ID.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "example": "Invalid URL: UUID parsing failed: invalid group length in group 4: expected 12, found 11"
              }
            }
          },
          "429": {
            "description": "Rate Limit Exceeded - Too many requests.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "rateLimitExceeded": {
                    "value": {
                      "error": "Too many requests. Please contact sales@dune.com to increase your limit."
                    }
                  }
                }
              }
            }
          }
        }
      },
      "put": {
        "tags": [
          "evm",
          "subscriptions"
        ],
        "summary": "Replace webhook addresses",
        "description": "Replaces the entire list of subscribed addresses for a webhook with a new list.",
        "operationId": "replaceWebhookAddresses",
        "parameters": [
          {
            "name": "webhookId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "description": "The unique identifier of the webhook."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReplaceAddresses"
              },
              "example": {
                "addresses": [
                  "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
                  "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Addresses replaced successfully. No response body."
          },
          "400": {
            "description": "Invalid webhook ID.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "example": "Invalid URL: UUID parsing failed: invalid group length in group 4: expected 12, found 11"
              }
            }
          },
          "429": {
            "description": "Rate Limit Exceeded - Too many requests.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "rateLimitExceeded": {
                    "value": {
                      "error": "Too many requests. Please contact sales@dune.com to increase your limit."
                    }
                  }
                }
              }
            }
          }
        }
      },
      "patch": {
        "tags": [
          "evm",
          "subscriptions"
        ],
        "summary": "Update webhook addresses",
        "description": "Add or remove individual addresses from a webhook subscription without replacing the entire list.",
        "operationId": "updateWebhookAddresses",
        "parameters": [
          {
            "name": "webhookId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "description": "The unique identifier of the webhook."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAddresses"
              },
              "examples": {
                "add_addresses": {
                  "summary": "Add addresses",
                  "value": {
                    "add_addresses": [
                      "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
                      "0x1234567890123456789012345678901234567890"
                    ]
                  }
                },
                "remove_addresses": {
                  "summary": "Remove addresses",
                  "value": {
                    "remove_addresses": [
                      "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C"
                    ]
                  }
                },
                "combined": {
                  "summary": "Add and remove in one request",
                  "value": {
                    "add_addresses": [
                      "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
                    ],
                    "remove_addresses": [
                      "0x3f60008Dfd0EfC03F476D9B489D6C5B13B3eBF2C"
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Addresses updated successfully. No response body."
          },
          "400": {
            "description": "Invalid webhook ID.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                },
                "example": "Invalid URL: UUID parsing failed: invalid group length in group 4: expected 12, found 11"
              }
            }
          },
          "429": {
            "description": "Rate Limit Exceeded - Too many requests.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "rateLimitExceeded": {
                    "value": {
                      "error": "Too many requests. Please contact sales@dune.com to increase your limit."
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/beta/svm/balances/{address}": {
      "get": {
        "tags": [
          "svm",
          "balances"
        ],
        "summary": "Get SVM token balances",
        "description": "Get token balances for a given SVM address",
        "operationId": "getSvmBalances",
        "parameters": [
          {
            "name": "address",
            "in": "path",
            "description": "SVM wallet address",
            "required": true,
            "schema": {
              "type": "string",
              "default": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY"
            },
            "example": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY"
          },
          {
            "name": "chains",
            "in": "query",
            "description": "Comma-separated list of chains to include. You can specify either solana or eclipse. For example, `?chains=solana,eclipse`. If omitted, the endpoint will default to solana only.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of results to return. Default is 1000 when not provided. Values above 1000 are reduced to 1000.",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000,
              "default": 1000
            }
          },
          {
            "name": "offset",
            "in": "query",
            "description": "Pagination offset from previous response",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SvmBalancesResponse"
                },
                "example": {
                  "processing_time_ms": 120,
                  "wallet_address": "DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK",
                  "next_offset": "eyJibG9ja190aW1lIjoxNjgwMDAwMDAwLCJpbmRleCI6MH0=",
                  "balances_count": 3,
                  "balances": [
                    {
                      "chain": "solana",
                      "address": "GUACAwFcHeHgN6FWhcw5Uwt8r9YHF1x66NWkW8fLT2e6",
                      "amount": "236604141098046680",
                      "balance": "2366041410980.4668",
                      "raw_balance": "2333343144265.50919",
                      "value_usd": 0,
                      "program_id": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb",
                      "decimals": 5,
                      "total_supply": "17752032227785985186",
                      "metadata_address": "GUACAwFcHeHgN6FWhcw5Uwt8r9YHF1x66NWkW8fLT2e6",
                      "name": "Solana Power Boost",
                      "symbol": "GUACA",
                      "uri": "https://arweave.net/0-6vSvbN2VhWi0dpufHxkcvul2TSYGQn7F-xAt867iY",
                      "price_usd": 0,
                      "liquidity_usd": 0
                    },
                    {
                      "chain": "solana",
                      "address": "HV6ia6ptzKbMPQs3zGrj2S35BhxeFzpXeSS3jNtW7P9F",
                      "amount": "913013423527",
                      "balance": "913013.423527",
                      "raw_balance": "912673",
                      "value_usd": 0,
                      "program_id": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb",
                      "decimals": 6,
                      "total_supply": "1000000000000",
                      "mint_authority": "4TM4eaLauigrqjDytC49K2iWKB4kAHsNRCJz48mdriHY",
                      "name": "FIRE",
                      "symbol": "FIRE",
                      "uri": "https://bafkreic4fzgkgta5qmv2tk2fug7i6jnrcmd4pnrf6pxwvyfxlne3ewb67i.ipfs.nftstorage.link",
                      "price_usd": 0,
                      "liquidity_usd": 0
                    },
                    {
                      "chain": "solana",
                      "address": "native",
                      "amount": "1000000000",
                      "balance": "1.0",
                      "raw_balance": "1.0",
                      "value_usd": 20.5,
                      "program_id": null,
                      "decimals": 9,
                      "total_supply": "1000000000000000",
                      "name": "Solana",
                      "symbol": "SOL",
                      "uri": null,
                      "price_usd": 20.5,
                      "liquidity_usd": 500000000,
                      "pool_type": null,
                      "pool_address": null,
                      "mint_authority": null
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - Invalid wallet address or invalid query parameter.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceMessageErrorResponse"
                },
                "examples": {
                  "invalidAddress": {
                    "summary": "Invalid address format",
                    "value": {
                      "message": "Failed to parse address"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized - Invalid or missing API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "invalidApiKey": {
                    "value": {
                      "error": "invalid API Key"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate Limit Exceeded - Too many requests.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "rateLimitExceeded": {
                    "value": {
                      "error": "Too many requests. Please contact sales@dune.com to increase your limit."
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceMessageErrorResponse"
                },
                "examples": {
                  "internalError": {
                    "value": {
                      "message": "Internal server error"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "Service Unavailable - The balances service is temporarily in a retry state. Retry the request after a short delay.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceMessageErrorResponse"
                },
                "examples": {
                  "serviceUnavailable": {
                    "value": {
                      "message": "Try again later"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/beta/svm/transactions/{address}": {
      "get": {
        "tags": [
          "svm",
          "transactions"
        ],
        "summary": "Get SVM transactions",
        "description": "Get transactions for a given SVM address",
        "operationId": "getSvmTransactions",
        "parameters": [
          {
            "name": "address",
            "in": "path",
            "description": "SVM wallet address",
            "required": true,
            "schema": {
              "type": "string",
              "default": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY"
            },
            "example": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY"
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of results to return. Default is 100 when not provided. Values above 1000 are reduced to 1000.",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "description": "Pagination offset from previous response",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SvmTransactionsResponse"
                },
                "example": {
                  "next_offset": "eyJibG9ja190aW1lIjoxNjgwMDAwMDAwLCJpbmRleCI6MH0=",
                  "transactions": [
                    {
                      "address": "DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK",
                      "block_slot": 123456789,
                      "block_time": 1680000000000000,
                      "chain": "solana",
                      "raw_transaction": {
                        "blockTime": 1680000000,
                        "meta": {
                          "err": null,
                          "fee": 5000,
                          "innerInstructions": [],
                          "logMessages": [
                            "Program 11111111111111111111111111111111 invoke [1]",
                            "Program 11111111111111111111111111111111 success"
                          ],
                          "postBalances": [
                            499995000,
                            10000000
                          ],
                          "postTokenBalances": [],
                          "preBalances": [
                            500000000,
                            0
                          ],
                          "preTokenBalances": [],
                          "rewards": [],
                          "status": {
                            "Ok": null
                          }
                        },
                        "slot": 123456789,
                        "transaction": {
                          "message": {
                            "accountKeys": [
                              "DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK",
                              "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin"
                            ],
                            "header": {
                              "numReadonlySignedAccounts": 0,
                              "numReadonlyUnsignedAccounts": 1,
                              "numRequiredSignatures": 1
                            },
                            "instructions": [
                              {
                                "accounts": [
                                  0,
                                  1
                                ],
                                "data": "3Bxs4h24hBtQy9rw",
                                "programIdIndex": 2
                              }
                            ],
                            "recentBlockhash": "11111111111111111111111111111111"
                          },
                          "signatures": [
                            "5SzSbWKM9yZC7cCGMhUhvnYdWQytrk9NBaWwug1gQBKKwNEBvBKqPSfVeYYnZwUuUyvcCHgYhDkTRrB6YBfwzfv8"
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - Invalid address or request parameter.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SvmTransactions_ErrorResponse"
                },
                "examples": {
                  "invalidRequest": {
                    "value": {
                      "message": "Invalid request"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized - Invalid or missing API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "invalidApiKey": {
                    "value": {
                      "error": "invalid API Key"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate Limit Exceeded - Too many requests.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GatewayErrorResponse"
                },
                "examples": {
                  "rateLimitExceeded": {
                    "value": {
                      "error": "Too many requests. Please contact sales@dune.com to increase your limit."
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SvmTransactions_ErrorResponse"
                },
                "examples": {
                  "internalError": {
                    "value": {
                      "message": "Internal server error"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Warning": {
        "type": "object",
        "required": [
          "code",
          "message"
        ],
        "properties": {
          "code": {
            "type": "string",
            "description": "Warning code identifier (e.g., 'UNSUPPORTED_CHAIN_IDS')",
            "example": "UNSUPPORTED_CHAIN_IDS"
          },
          "message": {
            "type": "string",
            "description": "Human-readable warning message",
            "example": "Some requested chain_ids are not supported. Activity is returned only for supported chains."
          },
          "chain_ids": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int64"
            },
            "description": "List of chain IDs that triggered this warning (for chain-related warnings)"
          },
          "docs_url": {
            "type": "string",
            "description": "URL to documentation with more information about the warning",
            "example": "https://docs.sim.dune.com/evm/supported-chains"
          }
        }
      },
      "HistoricalPricePoint": {
        "type": "object",
        "required": [
          "offset_hours",
          "price_usd"
        ],
        "properties": {
          "offset_hours": {
            "type": "integer",
            "format": "int32",
            "minimum": 1
          },
          "price_usd": {
            "type": "number",
            "format": "double"
          }
        }
      },
      "PoolMetadata": {
        "type": "object",
        "required": [
          "pool_type",
          "address",
          "tokens"
        ],
        "properties": {
          "pool_type": {
            "type": "string",
            "description": "The type of liquidity pool used for pricing (e.g., aerodrome_stable, uniswap_v2, uniswap_v3)"
          },
          "address": {
            "type": "string",
            "description": "The contract address of the liquidity pool"
          },
          "tokens": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Array of contract addresses for the tokens in the pool"
          }
        }
      },
      "BalanceErrorInformation": {
        "type": "object",
        "required": [
          "chain_id",
          "address"
        ],
        "properties": {
          "address": {
            "type": "string"
          },
          "chain_id": {
            "type": "integer",
            "format": "int64"
          },
          "description": {
            "type": "string"
          }
        }
      },
      "BalanceErrors": {
        "type": "object",
        "properties": {
          "error_message": {
            "type": "string"
          },
          "token_errors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BalanceErrorInformation"
            }
          }
        }
      },
      "ActivityItem": {
        "type": "object",
        "properties": {
          "chain_id": {
            "type": "integer",
            "format": "int64",
            "description": "ID of the blockchain where activity occurred"
          },
          "block_number": {
            "type": "integer",
            "format": "int64",
            "description": "Block number where activity occurred"
          },
          "block_time": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp of the block"
          },
          "tx_hash": {
            "type": "string",
            "description": "Hash of the transaction"
          },
          "type": {
            "type": "string",
            "description": "Activity type.",
            "enum": [
              "approve",
              "burn",
              "call",
              "mint",
              "receive",
              "send",
              "swap",
              "transfer"
            ]
          },
          "asset_type": {
            "type": "string",
            "description": "Asset standard of the activity.",
            "enum": [
              "native",
              "erc20",
              "erc721",
              "erc1155"
            ]
          },
          "token_address": {
            "type": "string",
            "description": "Contract address of token (for ERC20/ERC721/ERC1155)"
          },
          "from": {
            "type": "string",
            "description": "Address initiating the activity"
          },
          "to": {
            "type": "string",
            "description": "Recipient address"
          },
          "value": {
            "type": "string",
            "description": "Amount transferred (in WEI) or contract call value"
          },
          "value_usd": {
            "type": "number",
            "format": "double",
            "description": "USD value of the transaction"
          },
          "id": {
            "type": "string",
            "description": "Token ID (for ERC721/ERC1155 transfers)"
          },
          "spender": {
            "type": "string",
            "description": "Address being approved to spend tokens (for approve activities)"
          },
          "token_metadata": {
            "type": "object",
            "description": "Additional token information",
            "properties": {
              "symbol": {
                "type": "string",
                "description": "Token symbol"
              },
              "decimals": {
                "type": "integer",
                "description": "Token decimals"
              },
              "name": {
                "type": "string",
                "description": "Token name"
              },
              "logo": {
                "type": "string",
                "description": "URL to token logo"
              },
              "price_usd": {
                "type": "number",
                "format": "double",
                "description": "Token price in USD"
              },
              "pool_size": {
                "type": "number",
                "format": "double",
                "description": "Token pool size"
              },
              "standard": {
                "type": "string",
                "description": "Token standard (e.g., 'erc721')"
              }
            }
          },
          "function": {
            "type": "object",
            "description": "Decoded function information (for contract calls)",
            "properties": {
              "signature": {
                "type": "string",
                "description": "Function signature"
              },
              "name": {
                "type": "string",
                "description": "Function name"
              },
              "inputs": {
                "type": "array",
                "description": "Function parameters",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "Parameter name"
                    },
                    "type": {
                      "type": "string",
                      "description": "Parameter type"
                    },
                    "value": {
                      "type": "string",
                      "description": "Parameter value"
                    }
                  }
                }
              }
            }
          },
          "contract_metadata": {
            "type": "object",
            "description": "Contract metadata",
            "properties": {
              "name": {
                "type": "string",
                "description": "Contract name"
              }
            }
          },
          "from_token_address": {
            "type": "string",
            "description": "Source token address (for swaps)"
          },
          "from_token_value": {
            "type": "string",
            "description": "Source token amount (for swaps)"
          },
          "from_token_metadata": {
            "type": "object",
            "description": "Source token metadata (for swaps)",
            "properties": {
              "symbol": {
                "type": "string"
              },
              "decimals": {
                "type": "integer"
              },
              "name": {
                "type": "string"
              },
              "logo": {
                "type": "string"
              }
            }
          },
          "to_token_address": {
            "type": "string",
            "description": "Destination token address (for swaps)"
          },
          "to_token_value": {
            "type": "string",
            "description": "Destination token amount (for swaps)"
          },
          "to_token_metadata": {
            "type": "object",
            "description": "Destination token metadata (for swaps)",
            "properties": {
              "symbol": {
                "type": "string"
              },
              "decimals": {
                "type": "integer"
              },
              "name": {
                "type": "string"
              },
              "logo": {
                "type": "string"
              }
            }
          }
        }
      },
      "ActivityResponse": {
        "type": "object",
        "required": [
          "activity"
        ],
        "properties": {
          "activity": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ActivityItem"
            },
            "description": "Array of activity items"
          },
          "warnings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Warning"
            },
            "description": "Array of warnings that occurred during request processing. Warnings indicate non-fatal issues (e.g., unsupported chain IDs) where the request can still be partially fulfilled."
          },
          "next_offset": {
            "type": "string",
            "description": "Pagination cursor for the next page of results"
          }
        }
      },
      "BalanceData": {
        "type": "object",
        "required": [
          "chain",
          "address",
          "amount"
        ],
        "properties": {
          "address": {
            "type": "string"
          },
          "amount": {
            "type": "string"
          },
          "chain": {
            "type": "string"
          },
          "chain_id": {
            "type": "integer",
            "format": "int64"
          },
          "decimals": {
            "type": "integer",
            "format": "int64"
          },
          "low_liquidity": {
            "type": "boolean"
          },
          "name": {
            "type": "string"
          },
          "pool_size": {
            "type": "number",
            "format": "double"
          },
          "price_usd": {
            "type": "number",
            "format": "double"
          },
          "historical_prices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/HistoricalPricePoint"
            },
            "description": "Historical price points for the requested offsets. Only present when the historical_prices query parameter is provided."
          },
          "symbol": {
            "type": "string"
          },
          "token_metadata": {
            "type": "object",
            "properties": {
              "logo": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            }
          },
          "pool": {
            "allOf": [
              {
                "$ref": "#/components/schemas/PoolMetadata"
              }
            ],
            "description": "Liquidity pool information used for token pricing. Only present when metadata=pools is specified."
          },
          "value_usd": {
            "type": "number",
            "format": "double"
          }
        }
      },
      "BalancesResponse": {
        "type": "object",
        "required": [
          "wallet_address",
          "balances"
        ],
        "properties": {
          "balances": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BalanceData"
            }
          },
          "errors": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BalanceErrors"
              }
            ]
          },
          "warnings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Warning"
            },
            "description": "Array of warnings that occurred during request processing. Warnings indicate non-fatal issues (e.g., unsupported chain IDs) where the request can still be partially fulfilled."
          },
          "next_offset": {
            "type": "string",
            "description": "Use this value as the `offset` in your next request to continue pagination. Not included when there are no more balances."
          },
          "request_time": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp of when the request was received."
          },
          "response_time": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp of when the response was generated."
          },
          "wallet_address": {
            "type": "string",
            "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
          }
        }
      },
      "SingleBalanceResponse": {
        "type": "object",
        "required": [
          "wallet_address",
          "balances"
        ],
        "properties": {
          "balances": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BalanceData"
            }
          },
          "warnings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Warning"
            },
            "description": "Array of warnings that occurred during request processing. Warnings indicate non-fatal issues (e.g., unsupported chain IDs) where the request can still be partially fulfilled."
          },
          "request_time": {
            "type": "string",
            "format": "date-time"
          },
          "response_time": {
            "type": "string",
            "format": "date-time"
          },
          "wallet_address": {
            "type": "string",
            "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
          }
        }
      },
      "CollectibleEntry": {
        "type": "object",
        "properties": {
          "contract_address": {
            "type": "string",
            "format": "address",
            "description": "The contract address of the collectible."
          },
          "token_standard": {
            "type": "string",
            "enum": [
              "ERC721",
              "ERC1155"
            ],
            "description": "The token standard. Only ERC721 and ERC1155 are supported."
          },
          "token_id": {
            "type": "string",
            "description": "The token ID of the collectible."
          },
          "chain": {
            "type": "string",
            "description": "The blockchain name."
          },
          "chain_id": {
            "type": "integer",
            "format": "int32",
            "description": "The numeric EVM chain ID."
          },
          "name": {
            "type": "string",
            "description": "The name of the collectible."
          },
          "symbol": {
            "type": "string",
            "description": "The symbol of the collectible."
          },
          "description": {
            "type": "string",
            "description": "Description of the collectible."
          },
          "image_url": {
            "type": "string",
            "format": "uri",
            "description": "A URL that redirects to the image hosted by the collection or a CDN. Sim does not host images."
          },
          "last_sale_price": {
            "type": "string",
            "description": "The last sale price for this token ID, represented as a string."
          },
          "metadata": {
            "type": "object",
            "description": "Structured metadata for the token, resolved from the contract or its metadata URI. When present, it can include the original metadata URI and a list of normalized attributes. This object may be empty when no metadata is available.",
            "properties": {
              "uri": {
                "type": "string",
                "description": "Original metadata URI such as ipfs:// or an https URL."
              },
              "attributes": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "key": {
                      "type": "string",
                      "description": "Attribute name."
                    },
                    "value": {
                      "type": "string",
                      "description": "Attribute value."
                    },
                    "format": {
                      "type": "string",
                      "description": "Optional hint for interpreting the value (date, number, etc.)."
                    }
                  },
                  "required": [
                    "key",
                    "value"
                  ]
                }
              }
            }
          },
          "balance": {
            "type": "string",
            "description": "The balance of this specific token ID held by the address. For ERC721, this is typically '1'."
          },
          "last_acquired": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp of when this token ID was last acquired by the address."
          },
          "is_spam": {
            "type": "boolean",
            "description": "Whether the collection is classified as spam."
          },
          "spam_score": {
            "type": "integer",
            "format": "int32",
            "minimum": 0,
            "maximum": 100,
            "description": "0\u2013100 confidence score that the collection is spam. Included only when `show_spam_scores=true`. May be omitted when scores are unavailable. See the [Spam Filtering](#spam-filtering) section for more details."
          },
          "explanations": {
            "type": "array",
            "description": "Signals contributing to the spam score. Included only when `show_spam_scores=true`. May be omitted when scores are unavailable.",
            "items": {
              "type": "object",
              "properties": {
                "feature": {
                  "type": "string",
                  "description": "Signal used in scoring.",
                  "enum": [
                    "trade_volume",
                    "unique_buyers",
                    "unique_sellers",
                    "externally_flagged",
                    "uri_non_ipfs",
                    "suspicious_words",
                    "url_shortener",
                    "manual_classification"
                  ]
                },
                "value": {
                  "description": "Observed value for the feature (type varies by feature).",
                  "oneOf": [
                    {
                      "type": "integer",
                      "format": "int32"
                    },
                    {
                      "type": "boolean"
                    },
                    {
                      "type": "string"
                    }
                  ]
                },
                "feature_score": {
                  "type": "integer",
                  "format": "int32",
                  "minimum": 0,
                  "maximum": 100,
                  "description": "0\u2013100 contribution of this feature to the spam score."
                },
                "feature_weight": {
                  "type": "number",
                  "format": "float",
                  "minimum": 0,
                  "maximum": 1,
                  "description": "Weight applied to this feature in the weighted average."
                }
              },
              "required": [
                "feature"
              ]
            }
          }
        },
        "required": [
          "contract_address",
          "token_standard",
          "token_id",
          "chain",
          "chain_id",
          "balance",
          "last_acquired",
          "is_spam"
        ]
      },
      "CollectiblesResponse": {
        "type": "object",
        "properties": {
          "address": {
            "type": "string",
            "format": "address",
            "description": "The wallet address for which collectibles are being reported."
          },
          "entries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CollectibleEntry"
            },
            "description": "A list of collectible entries."
          },
          "warnings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Warning"
            },
            "description": "Array of warnings that occurred during request processing. Warnings indicate non-fatal issues (e.g., unsupported chain IDs) where the request can still be partially fulfilled."
          },
          "next_offset": {
            "type": "string",
            "description": "Use this value as the `offset` in your next request to continue pagination. Not included when there are no more entries."
          },
          "request_time": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp of when the request was received."
          },
          "response_time": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp of when the response was generated."
          }
        },
        "required": [
          "address",
          "entries",
          "request_time",
          "response_time"
        ]
      },
      "DefiPosition": {
        "type": "object",
        "required": [
          "type",
          "chain_id",
          "usd_value"
        ],
        "description": "Position entry for a wallet. The shape varies by `type`. Fields are included only when relevant to the position type.",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "Erc4626",
              "Tokenized",
              "UniswapV2",
              "Nft",
              "NftV4"
            ],
            "description": "Position type discriminator. Values: `Erc4626` (ERC-4626 vaults), `Tokenized` (tokenized lending e.g., aTokens), `UniswapV2` (AMM LP), `Nft` (Uniswap V3 NFT), `NftV4` (Uniswap V4 NFT)."
          },
          "chain_id": {
            "type": "integer",
            "format": "int64",
            "description": "Numeric EVM chain ID."
          },
          "usd_value": {
            "type": "number",
            "format": "double",
            "description": "Total USD value of this position."
          },
          "logo": {
            "type": "string",
            "nullable": true,
            "description": "URL to a token logo, when available."
          },
          "token_type": {
            "type": "string",
            "description": "Tokenized position variant (e.g., Aave aToken version). Present only when `type=Tokenized`."
          },
          "token": {
            "type": "string",
            "description": "ERC20 or vault token contract address. Present only when `type=Erc4626` or `type=Tokenized`."
          },
          "token_name": {
            "type": "string",
            "description": "Token name. Present only when `type=Erc4626` or `type=Tokenized`."
          },
          "token_symbol": {
            "type": "string",
            "description": "Token symbol. Present only when `type=Erc4626` or `type=Tokenized`."
          },
          "underlying_token": {
            "type": "string",
            "description": "Underlying ERC20 token contract address. Present only when `type=Erc4626`."
          },
          "underlying_token_name": {
            "type": "string",
            "description": "Underlying token name. Present only when `type=Erc4626`."
          },
          "underlying_token_symbol": {
            "type": "string",
            "description": "Underlying token symbol. Present only when `type=Erc4626`."
          },
          "underlying_token_decimals": {
            "type": "integer",
            "format": "int32",
            "description": "Underlying token decimals. Present only when `type=Erc4626`."
          },
          "calculated_balance": {
            "type": "number",
            "format": "double",
            "description": "Balance adjusted for decimals. Present only when `type=Erc4626`, `type=Tokenized`, or `type=UniswapV2`."
          },
          "price_in_usd": {
            "type": "number",
            "format": "double",
            "description": "USD unit price for the position's quantity (e.g., per token or derived for LP). May be 0 when unavailable. Present only when `type=Erc4626`, `type=Tokenized`, or `type=UniswapV2`."
          },
          "protocol": {
            "type": "string",
            "description": "Protocol identifier (e.g., UniswapV2, UniswapV3, UniswapV4). Present only when `type=UniswapV2`, `type=Nft`, or `type=NftV4`."
          },
          "pool": {
            "type": "string",
            "description": "Pool contract address. Present only when `type=UniswapV2` or `type=Nft`."
          },
          "pool_id": {
            "type": "array",
            "description": "Byte-encoded pool identifier as an array of integers (0\u2013255). Present only when `type=NftV4`.",
            "items": {
              "type": "integer",
              "format": "int32"
            }
          },
          "pool_manager": {
            "type": "string",
            "description": "Uniswap V4 pool manager contract address. Present only when `type=NftV4`."
          },
          "salt": {
            "type": "array",
            "description": "Salt used in Uniswap V4 pool address derivation as an array of integers (0\u2013255). Present only when `type=NftV4`.",
            "items": {
              "type": "integer",
              "format": "int32"
            }
          },
          "token0": {
            "type": "string",
            "description": "Token0 contract address. Present only when `type=UniswapV2`, `type=Nft`, or `type=NftV4`."
          },
          "token0_name": {
            "type": "string",
            "description": "Token0 name. Present only when `type=UniswapV2`, `type=Nft`, or `type=NftV4`."
          },
          "token0_symbol": {
            "type": "string",
            "description": "Token0 symbol. Present only when `type=UniswapV2`, `type=Nft`, or `type=NftV4`."
          },
          "token0_decimals": {
            "type": "integer",
            "format": "int32",
            "description": "Token0 decimals. Present only when `type=UniswapV2`, `type=Nft`, or `type=NftV4`."
          },
          "token1": {
            "type": "string",
            "description": "Token1 contract address. Present only when `type=UniswapV2`, `type=Nft`, or `type=NftV4`."
          },
          "token1_name": {
            "type": "string",
            "description": "Token1 name. Present only when `type=UniswapV2`, `type=Nft`, or `type=NftV4`."
          },
          "token1_symbol": {
            "type": "string",
            "description": "Token1 symbol. Present only when `type=UniswapV2`, `type=Nft`, or `type=NftV4`."
          },
          "token1_decimals": {
            "type": "integer",
            "format": "int32",
            "description": "Token1 decimals. Present only when `type=UniswapV2`, `type=Nft`, or `type=NftV4`."
          },
          "lp_balance": {
            "type": "string",
            "description": "Raw LP token balance as a 0x-prefixed hex string. Present only when `type=UniswapV2`."
          },
          "token0_price": {
            "type": "number",
            "format": "double",
            "description": "USD price per token0. Present only when `type=UniswapV2`, `type=Nft`, or `type=NftV4`."
          },
          "token1_price": {
            "type": "number",
            "format": "double",
            "description": "USD price per token1. Present only when `type=UniswapV2`, `type=Nft`, or `type=NftV4`."
          },
          "positions": {
            "type": "array",
            "description": "Concentrated liquidity NFT positions for Uniswap V3/V4. Present only when `type=Nft` or `type=NftV4`.",
            "items": {
              "$ref": "#/components/schemas/NftPositionDetails"
            }
          }
        }
      },
      "Erc4626Position": {
        "type": "object",
        "required": [
          "type",
          "chain_id",
          "token",
          "token_symbol",
          "calculated_balance",
          "usd_value"
        ],
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "Erc4626"
            ],
            "description": "Position type discriminator."
          },
          "chain_id": {
            "type": "integer",
            "format": "int64",
            "description": "Numeric EVM chain ID."
          },
          "token": {
            "type": "string",
            "description": "ERC-4626 vault token contract address."
          },
          "token_name": {
            "type": "string",
            "description": "Vault token name."
          },
          "token_symbol": {
            "type": "string",
            "description": "Vault token symbol."
          },
          "underlying_token": {
            "type": "string",
            "description": "Underlying ERC20 token contract address."
          },
          "underlying_token_name": {
            "type": "string",
            "description": "Underlying token name."
          },
          "underlying_token_symbol": {
            "type": "string",
            "description": "Underlying token symbol."
          },
          "underlying_token_decimals": {
            "type": "integer",
            "format": "int32",
            "description": "Underlying token decimals."
          },
          "calculated_balance": {
            "type": "number",
            "format": "double",
            "description": "Vault balance adjusted for decimals."
          },
          "price_in_usd": {
            "type": "number",
            "format": "double",
            "description": "USD price per vault token. May be 0 when unavailable."
          },
          "usd_value": {
            "type": "number",
            "format": "double",
            "description": "USD value of this position."
          },
          "logo": {
            "type": "string",
            "nullable": true,
            "description": "URL to a token logo, when available."
          }
        }
      },
      "TokenizedPosition": {
        "type": "object",
        "required": [
          "type",
          "chain_id",
          "token",
          "token_symbol",
          "calculated_balance",
          "usd_value"
        ],
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "Tokenized"
            ],
            "description": "Position type discriminator."
          },
          "chain_id": {
            "type": "integer",
            "format": "int64",
            "description": "Numeric EVM chain ID."
          },
          "token_type": {
            "type": "string",
            "description": "Tokenized position variant (e.g., Aave aToken version)."
          },
          "token": {
            "type": "string",
            "description": "Token contract address representing the position."
          },
          "token_name": {
            "type": "string",
            "description": "Token name."
          },
          "token_symbol": {
            "type": "string",
            "description": "Token symbol."
          },
          "calculated_balance": {
            "type": "number",
            "format": "double",
            "description": "Token balance adjusted for decimals."
          },
          "price_in_usd": {
            "type": "number",
            "format": "double",
            "description": "USD price per token."
          },
          "usd_value": {
            "type": "number",
            "format": "double",
            "description": "USD value of this position."
          },
          "logo": {
            "type": "string",
            "nullable": true,
            "description": "URL to a token logo, when available."
          }
        }
      },
      "UniswapV2Position": {
        "type": "object",
        "required": [
          "type",
          "protocol",
          "chain_id",
          "pool",
          "token0",
          "token1",
          "calculated_balance",
          "usd_value"
        ],
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "UniswapV2"
            ],
            "description": "Position type discriminator."
          },
          "protocol": {
            "type": "string",
            "description": "Protocol identifier. Present for AMM positions such as Uniswap V2; not included for `Erc4626` and `Tokenized` types.",
            "example": "UniswapV2"
          },
          "chain_id": {
            "type": "integer",
            "format": "int64",
            "description": "Numeric EVM chain ID."
          },
          "pool": {
            "type": "string",
            "description": "Uniswap V2 pair contract address."
          },
          "token0": {
            "type": "string",
            "description": "Token0 contract address."
          },
          "token0_name": {
            "type": "string",
            "description": "Token0 name."
          },
          "token0_symbol": {
            "type": "string",
            "description": "Token0 symbol."
          },
          "token0_decimals": {
            "type": "integer",
            "format": "int32",
            "description": "Token0 decimals."
          },
          "token1": {
            "type": "string",
            "description": "Token1 contract address."
          },
          "token1_name": {
            "type": "string",
            "description": "Token1 name."
          },
          "token1_symbol": {
            "type": "string",
            "description": "Token1 symbol."
          },
          "token1_decimals": {
            "type": "integer",
            "format": "int32",
            "description": "Token1 decimals."
          },
          "lp_balance": {
            "type": "string",
            "description": "Raw LP token balance as a 0x-prefixed hex string."
          },
          "token0_price": {
            "type": "number",
            "format": "double",
            "description": "USD price per token0."
          },
          "token1_price": {
            "type": "number",
            "format": "double",
            "description": "USD price per token1."
          },
          "calculated_balance": {
            "type": "number",
            "format": "double",
            "description": "Derived underlying token amount or pool share depending on the position."
          },
          "price_in_usd": {
            "type": "number",
            "format": "double",
            "description": "USD unit price corresponding to the computed balance."
          },
          "usd_value": {
            "type": "number",
            "format": "double",
            "description": "Total USD value of this position."
          },
          "logo": {
            "type": "string",
            "nullable": true,
            "description": "URL to a token logo, when available."
          }
        }
      },
      "NftPositionDetails": {
        "type": "object",
        "required": [
          "tick_lower",
          "tick_upper",
          "token_id",
          "token0_price",
          "token1_price"
        ],
        "properties": {
          "tick_lower": {
            "type": "integer",
            "format": "int32",
            "description": "Lower tick bound."
          },
          "tick_upper": {
            "type": "integer",
            "format": "int32",
            "description": "Upper tick bound."
          },
          "token_id": {
            "type": "string",
            "description": "NFT token ID represented as a 0x-prefixed hex string."
          },
          "token0_price": {
            "type": "number",
            "format": "double",
            "description": "USD price per token0 at evaluation."
          },
          "token0_holdings": {
            "type": "number",
            "format": "double",
            "description": "Amount of token0 represented by the position."
          },
          "token0_rewards": {
            "type": "number",
            "format": "double",
            "description": "Unclaimed token0 rewards accrued by the position."
          },
          "token1_price": {
            "type": "number",
            "format": "double",
            "description": "USD price per token1 at evaluation."
          },
          "token1_holdings": {
            "type": "number",
            "format": "double",
            "description": "Amount of token1 represented by the position."
          },
          "token1_rewards": {
            "type": "number",
            "format": "double",
            "description": "Unclaimed token1 rewards accrued by the position."
          }
        }
      },
      "UniswapV3NftPosition": {
        "type": "object",
        "required": [
          "type",
          "protocol",
          "chain_id",
          "pool",
          "token0",
          "token1",
          "positions",
          "usd_value"
        ],
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "Nft"
            ],
            "description": "Position type discriminator."
          },
          "protocol": {
            "type": "string",
            "description": "Protocol identifier. Present for AMM positions such as Uniswap V3; not included for `Erc4626` and `Tokenized` types.",
            "example": "UniswapV3"
          },
          "chain_id": {
            "type": "integer",
            "format": "int64",
            "description": "Numeric EVM chain ID."
          },
          "pool": {
            "type": "string",
            "description": "Uniswap V3 pool contract address."
          },
          "token0": {
            "type": "string",
            "description": "Token0 contract address."
          },
          "token0_name": {
            "type": "string",
            "description": "Token0 name."
          },
          "token0_symbol": {
            "type": "string",
            "description": "Token0 symbol."
          },
          "token0_decimals": {
            "type": "integer",
            "format": "int32",
            "description": "Token0 decimals."
          },
          "token1": {
            "type": "string",
            "description": "Token1 contract address."
          },
          "token1_name": {
            "type": "string",
            "description": "Token1 name."
          },
          "token1_symbol": {
            "type": "string",
            "description": "Token1 symbol."
          },
          "token1_decimals": {
            "type": "integer",
            "format": "int32",
            "description": "Token1 decimals."
          },
          "positions": {
            "type": "array",
            "description": "One or more concentrated liquidity NFT positions in this pool.",
            "items": {
              "$ref": "#/components/schemas/NftPositionDetails"
            }
          },
          "logo": {
            "type": "string",
            "nullable": true,
            "description": "URL to a token logo, when available."
          },
          "usd_value": {
            "type": "number",
            "format": "double",
            "description": "USD value of this NFT position (including both tokens)."
          }
        }
      },
      "UniswapV4NftPosition": {
        "type": "object",
        "required": [
          "type",
          "protocol",
          "chain_id",
          "pool_id",
          "pool_manager",
          "salt",
          "token0",
          "token1",
          "positions",
          "usd_value"
        ],
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "NftV4"
            ],
            "description": "Position type discriminator."
          },
          "protocol": {
            "type": "string",
            "description": "Protocol identifier. Present for AMM positions such as Uniswap V4; not included for `Erc4626` and `Tokenized` types.",
            "example": "UniswapV4"
          },
          "chain_id": {
            "type": "integer",
            "format": "int64",
            "description": "Numeric EVM chain ID."
          },
          "pool_id": {
            "type": "array",
            "description": "Byte-encoded pool identifier, represented as an array of integers (0\u2013255).",
            "items": {
              "type": "integer",
              "format": "int32"
            }
          },
          "pool_manager": {
            "type": "string",
            "description": "Uniswap V4 pool manager contract address."
          },
          "salt": {
            "type": "array",
            "description": "Salt used in pool address derivation, represented as an array of integers (0\u2013255).",
            "items": {
              "type": "integer",
              "format": "int32"
            }
          },
          "token0": {
            "type": "string",
            "description": "Token0 contract address. `0x000\u2026000` denotes the chain's native asset."
          },
          "token0_name": {
            "type": "string",
            "description": "Token0 name."
          },
          "token0_symbol": {
            "type": "string",
            "description": "Token0 symbol."
          },
          "token0_decimals": {
            "type": "integer",
            "format": "int32",
            "description": "Token0 decimals."
          },
          "token1": {
            "type": "string",
            "description": "Token1 contract address."
          },
          "token1_name": {
            "type": "string",
            "description": "Token1 name."
          },
          "token1_symbol": {
            "type": "string",
            "description": "Token1 symbol."
          },
          "token1_decimals": {
            "type": "integer",
            "format": "int32",
            "description": "Token1 decimals."
          },
          "positions": {
            "type": "array",
            "description": "One or more concentrated liquidity NFT positions in this pool.",
            "items": {
              "$ref": "#/components/schemas/NftPositionDetails"
            }
          },
          "logo": {
            "type": "string",
            "nullable": true,
            "description": "URL to a token logo, when available."
          },
          "usd_value": {
            "type": "number",
            "format": "double",
            "description": "USD value of this NFT position (including both tokens)."
          }
        }
      },
      "DefiAggregations": {
        "type": "object",
        "properties": {
          "total_usd_value": {
            "type": "number",
            "format": "double",
            "description": "Sum of the USD value across all returned positions."
          },
          "total_by_chain": {
            "type": "object",
            "description": "Breakdown of USD value by chain, keyed by chain ID as a string.",
            "additionalProperties": {
              "type": "number",
              "format": "double"
            }
          }
        }
      },
      "DefiPositionsResponse": {
        "type": "object",
        "required": [
          "positions"
        ],
        "properties": {
          "positions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DefiPosition"
            }
          },
          "aggregations": {
            "allOf": [
              {
                "$ref": "#/components/schemas/DefiAggregations"
              }
            ]
          },
          "warnings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Warning"
            },
            "description": "Array of warnings that occurred during request processing. Warnings indicate non-fatal issues (e.g., unsupported chain IDs) where the request can still be partially fulfilled."
          }
        }
      },
      "StablecoinBalanceData": {
        "type": "object",
        "required": [
          "chain",
          "address",
          "amount"
        ],
        "properties": {
          "address": {
            "type": "string",
            "description": "Token contract address, or 'native' for native stablecoins like xDAI on Gnosis"
          },
          "amount": {
            "type": "string"
          },
          "chain": {
            "type": "string"
          },
          "chain_id": {
            "type": "integer",
            "format": "int64"
          },
          "decimals": {
            "type": "integer",
            "format": "int64"
          },
          "low_liquidity": {
            "type": "boolean"
          },
          "name": {
            "type": "string"
          },
          "pool_size": {
            "type": "number",
            "format": "double"
          },
          "price_usd": {
            "type": "number",
            "format": "double"
          },
          "historical_prices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/HistoricalPricePoint"
            },
            "description": "Historical price points for the requested offsets. Only present when the historical_prices query parameter is provided."
          },
          "symbol": {
            "type": "string"
          },
          "token_metadata": {
            "type": "object",
            "properties": {
              "logo": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            }
          },
          "pool": {
            "allOf": [
              {
                "$ref": "#/components/schemas/PoolMetadata"
              }
            ],
            "description": "Liquidity pool information used for token pricing. Only present when metadata=pools is specified."
          },
          "value_usd": {
            "type": "number",
            "format": "double"
          }
        }
      },
      "StablecoinBalancesResponse": {
        "type": "object",
        "required": [
          "wallet_address",
          "balances"
        ],
        "properties": {
          "balances": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/StablecoinBalanceData"
            }
          },
          "errors": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BalanceErrors"
              }
            ]
          },
          "warnings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Warning"
            },
            "description": "Array of warnings that occurred during request processing. Warnings indicate non-fatal issues (e.g., unsupported chain IDs) where the request can still be partially fulfilled."
          },
          "next_offset": {
            "type": "string",
            "description": "Use this value as the `offset` in your next request to continue pagination. Not included when there are no more balances."
          },
          "request_time": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp of when the request was received."
          },
          "response_time": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp of when the response was generated."
          },
          "wallet_address": {
            "type": "string",
            "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
          }
        }
      },
      "ChainEntry": {
        "type": "object",
        "required": [
          "name",
          "id",
          "tags"
        ],
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64",
            "description": "The chain ID"
          },
          "name": {
            "type": "string",
            "description": "The name of the chain"
          },
          "supported_assets": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Types of assets supported on this chain (e.g., 'native', 'erc20', 'erc721')"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Tags associated with this chain (e.g., 'default', 'mainnet', 'testnet')"
          },
          "rpc_url": {
            "type": "string",
            "description": "The RPC URL for this chain"
          },
          "explorer_url": {
            "type": "string",
            "description": "The block explorer URL for this chain"
          },
          "logo": {
            "type": "string",
            "description": "URL to the chain's logo"
          }
        }
      },
      "ChainsResponse": {
        "type": "object",
        "required": [
          "chains"
        ],
        "properties": {
          "chains": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ChainEntry"
            },
            "description": "Array of supported chains"
          }
        }
      },
      "ErrorDetail": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "Description of what went wrong.",
            "example": "Invalid or missing API key"
          },
          "code": {
            "type": "string",
            "description": "Error code.",
            "example": "UNAUTHORIZED"
          }
        },
        "required": [
          "message",
          "code"
        ]
      },
      "Holder": {
        "type": "object",
        "properties": {
          "wallet_address": {
            "type": "string",
            "description": "The address of the token holder.",
            "example": "0x4a79b0168296c0ef7b8f314973b82ad406a29f1b"
          },
          "balance": {
            "type": "string",
            "description": "The raw balance of tokens held by the address, as a string to support large numbers.",
            "example": "13794442047246482254818"
          },
          "first_acquired": {
            "type": "string",
            "format": "date-time",
            "description": "The timestamp when the holder first acquired tokens.",
            "example": "2025-02-06T15:11:07+00:00"
          },
          "has_initiated_transfer": {
            "type": "boolean",
            "description": "Indicates if the holder has initiated a transfer of these tokens.",
            "example": false
          }
        }
      },
      "TokenHoldersResponse": {
        "type": "object",
        "properties": {
          "token_address": {
            "type": "string",
            "format": "address",
            "description": "The address of the token contract.",
            "example": "0x63706e401c06ac8513145b7687a14804d17f814b"
          },
          "chain_id": {
            "type": "integer",
            "format": "int32",
            "description": "The identifier of the blockchain. For a full list see Supported Chains",
            "example": 8453
          },
          "holders": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Holder"
            },
            "description": "A list of token holders and their balances."
          },
          "next_offset": {
            "type": "string",
            "description": "An opaque token for fetching the next page of results. Null if no more results.",
            "example": "eyJvZmZzZXQiOjEwMH0="
          }
        }
      },
      "TokenInfo": {
        "type": "object",
        "properties": {
          "chain": {
            "type": "string",
            "description": "The name of the blockchain"
          },
          "chain_id": {
            "type": "integer",
            "format": "int64",
            "description": "The ID of the blockchain"
          },
          "symbol": {
            "type": "string",
            "description": "The token symbol"
          },
          "name": {
            "type": "string",
            "description": "The token name"
          },
          "decimals": {
            "type": "integer",
            "description": "The number of decimals for the token"
          },
          "price_usd": {
            "type": "number",
            "format": "double",
            "description": "The price of the token in USD"
          },
          "historical_prices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/HistoricalPricePoint"
            },
            "description": "Historical price points for the requested offsets. Only present when the historical_prices query parameter is provided."
          },
          "total_supply": {
            "type": "string",
            "description": "The total supply of the token"
          },
          "market_cap": {
            "type": "number",
            "format": "double",
            "description": "The market capitalization of the token"
          },
          "logo": {
            "type": "string",
            "description": "URL to the token logo"
          }
        }
      },
      "TokensResponse": {
        "type": "object",
        "required": [
          "contract_address",
          "tokens"
        ],
        "properties": {
          "contract_address": {
            "type": "string",
            "description": "The contract address of the token or 'native' for the native token"
          },
          "tokens": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TokenInfo"
            },
            "description": "Array of token information across different chains"
          },
          "warnings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Warning"
            },
            "description": "Array of warnings that occurred during request processing. Warnings indicate non-fatal issues (e.g., unsupported chain IDs) where the request can still be partially fulfilled."
          },
          "next_offset": {
            "type": "string",
            "description": "Pagination cursor for the next page of results"
          }
        }
      },
      "Transaction": {
        "type": "object",
        "required": [
          "address",
          "block_hash",
          "block_number",
          "block_time",
          "chain",
          "from",
          "hash"
        ],
        "properties": {
          "address": {
            "type": "string",
            "description": "Wallet or ERC20 contract address"
          },
          "block_hash": {
            "type": "string",
            "description": "Unique cryptographic block identifier"
          },
          "block_number": {
            "type": "string",
            "description": "Block's sequential index"
          },
          "block_time": {
            "type": "string",
            "description": "Timestamp of block creation"
          },
          "block_version": {
            "type": "integer",
            "description": "Block's protocol iteration"
          },
          "chain": {
            "type": "string",
            "description": "Name of the blockchain"
          },
          "from": {
            "type": "string",
            "description": "Address of sender"
          },
          "to": {
            "type": "string",
            "description": "Address of receiver"
          },
          "data": {
            "type": "string",
            "description": "Data of transaction"
          },
          "gas_price": {
            "type": "string",
            "description": "Gas price of transaction as hexadecimal string"
          },
          "hash": {
            "type": "string",
            "description": "Hash of transaction"
          },
          "index": {
            "type": "string",
            "description": "Index of transaction"
          },
          "max_fee_per_gas": {
            "type": "string",
            "description": "Max fee per gas of transaction as hexadecimal string"
          },
          "max_priority_fee_per_gas": {
            "type": "string",
            "description": "Max priority fee per gas of transaction as hexadecimal string"
          },
          "nonce": {
            "type": "string",
            "description": "Nonce of transaction as hexadecimal string"
          },
          "transaction_type": {
            "type": "string",
            "description": "Type of transaction"
          },
          "value": {
            "type": "string",
            "description": "Value of transaction as hexadecimal string"
          },
          "decoded": {
            "type": "object",
            "description": "Present only when decode=true and a matching ABI signature is found on Dune.com for the transaction's call data.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Decoded function name"
              },
              "inputs": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/DecodedInput"
                }
              }
            }
          },
          "logs": {
            "type": "array",
            "description": "Raw EVM logs for this transaction. When decoding is enabled via the decode query parameter, individual log entries may include a decoded object.",
            "items": {
              "$ref": "#/components/schemas/TransactionLog"
            }
          }
        }
      },
      "TransactionLog": {
        "type": "object",
        "properties": {
          "address": {
            "type": "string",
            "description": "Contract address that emitted the log"
          },
          "data": {
            "type": "string",
            "description": "Hex-encoded log data"
          },
          "topics": {
            "type": "array",
            "description": "Array of 0x-prefixed topic hashes",
            "items": {
              "type": "string"
            }
          },
          "decoded": {
            "type": "object",
            "description": "Present only when decode=true and a matching ABI signature is found for this log.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Decoded event name"
              },
              "inputs": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/DecodedInput"
                }
              }
            }
          }
        }
      },
      "DecodedInput": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "value": {
            "description": "Decoded parameter value. Scalar values are strings; array-type ABI parameters (e.g. bytes[], address[]) are arrays of strings.",
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            ]
          }
        }
      },
      "TransactionErrorInformation": {
        "type": "object",
        "required": [
          "chain_id",
          "address"
        ],
        "properties": {
          "address": {
            "type": "string"
          },
          "chain_id": {
            "type": "integer",
            "format": "int64"
          },
          "description": {
            "type": "string"
          }
        }
      },
      "TransactionErrors": {
        "type": "object",
        "properties": {
          "error_message": {
            "type": "string"
          },
          "transaction_errors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TransactionErrorInformation"
            }
          }
        }
      },
      "TransactionsResponse": {
        "type": "object",
        "required": [
          "wallet_address",
          "transactions"
        ],
        "properties": {
          "transactions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Transaction"
            }
          },
          "errors": {
            "allOf": [
              {
                "$ref": "#/components/schemas/TransactionErrors"
              }
            ]
          },
          "warnings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Warning"
            },
            "description": "Array of warnings that occurred during request processing. Warnings indicate non-fatal issues (e.g., unsupported chain IDs) where the request can still be partially fulfilled."
          },
          "next_offset": {
            "type": "string"
          },
          "request_time": {
            "type": "string"
          },
          "response_time": {
            "type": "string"
          },
          "wallet_address": {
            "type": "string",
            "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
          }
        }
      },
      "WebhookType": {
        "type": "string",
        "enum": [
          "transactions",
          "activities",
          "balances"
        ],
        "description": "The type of onchain event to subscribe to."
      },
      "TransactionType": {
        "type": "string",
        "enum": [
          "sender",
          "receiver"
        ],
        "description": "ONLY for 'transactions' type webhooks. Filter by whether the subscribed address is the sender or receiver. Cannot be used with 'balances' or 'activities' webhook types."
      },
      "ActivityType": {
        "type": "string",
        "enum": [
          "approve",
          "mint",
          "burn",
          "receive",
          "send",
          "swap",
          "call"
        ],
        "description": "ONLY for 'activities' type webhooks. Filter by specific activity types. Cannot be used with 'balances' or 'transactions' webhook types."
      },
      "AssetType": {
        "type": "string",
        "enum": [
          "native",
          "erc20",
          "erc721",
          "erc1155"
        ],
        "description": "Filter by asset type."
      },
      "Webhook": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "The unique identifier for the webhook."
          },
          "team_id": {
            "type": "string",
            "description": "The team ID that owns this webhook."
          },
          "name": {
            "type": "string",
            "description": "A descriptive name for the webhook."
          },
          "type": {
            "$ref": "#/components/schemas/WebhookType"
          },
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The URL where webhook payloads will be sent."
          },
          "active": {
            "type": "boolean",
            "description": "Whether the webhook is currently active."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "When the webhook was created."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "When the webhook was last updated."
          },
          "chain_ids": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int64"
            },
            "nullable": true,
            "description": "Filter events to specific chain IDs. If null, all supported chains are included."
          },
          "transaction_type": {
            "allOf": [
              {
                "$ref": "#/components/schemas/TransactionType"
              }
            ],
            "nullable": true,
            "description": "For transaction webhooks, filter by sender or receiver.",
            "type": "string"
          },
          "counterparty": {
            "type": "string",
            "nullable": true,
            "description": "Filter transactions by counterparty address.",
            "example": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
          },
          "activity_type": {
            "allOf": [
              {
                "$ref": "#/components/schemas/ActivityType"
              }
            ],
            "nullable": true,
            "description": "For activity webhooks, filter by specific activity type.",
            "type": "string"
          },
          "asset_type": {
            "allOf": [
              {
                "$ref": "#/components/schemas/AssetType"
              }
            ],
            "nullable": true,
            "description": "Filter by asset type.",
            "type": "string"
          },
          "token_address": {
            "type": "string",
            "nullable": true,
            "description": "Filter events to a specific token address.",
            "example": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
          }
        }
      },
      "WebhooksList": {
        "type": "object",
        "properties": {
          "webhooks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Webhook"
            }
          },
          "next_offset": {
            "type": "string",
            "description": "Cursor for pagination. Pass this value as the offset parameter to get the next page."
          }
        }
      },
      "CreateWebhook": {
        "type": "object",
        "required": [
          "name",
          "url",
          "type",
          "addresses"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "A descriptive name for the webhook."
          },
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The URL where webhook payloads will be sent."
          },
          "type": {
            "$ref": "#/components/schemas/WebhookType"
          },
          "addresses": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "EVM address."
            },
            "description": "List of addresses to monitor."
          },
          "chain_ids": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int64"
            },
            "nullable": true,
            "description": "Filter events to specific chain IDs. If omitted, all supported chains are included."
          },
          "transaction_type": {
            "allOf": [
              {
                "$ref": "#/components/schemas/TransactionType"
              }
            ],
            "nullable": true,
            "description": "ONLY for 'transactions' type webhooks. Filter by sender or receiver. Cannot be used with other webhook types.",
            "type": "string"
          },
          "counterparty": {
            "type": "string",
            "nullable": true,
            "description": "ONLY for 'transactions' type webhooks. Filter transactions by counterparty address."
          },
          "activity_type": {
            "allOf": [
              {
                "$ref": "#/components/schemas/ActivityType"
              }
            ],
            "nullable": true,
            "description": "ONLY for 'activities' type webhooks. Filter by specific activity type. Cannot be used with other webhook types.",
            "type": "string"
          },
          "asset_type": {
            "allOf": [
              {
                "$ref": "#/components/schemas/AssetType"
              }
            ],
            "nullable": true,
            "description": "Filter by asset type.",
            "type": "string"
          },
          "token_address": {
            "type": "string",
            "nullable": true,
            "description": "Filter events to a specific token address."
          }
        }
      },
      "UpdateWebhook": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "nullable": true,
            "description": "Update the webhook name."
          },
          "url": {
            "type": "string",
            "format": "uri",
            "nullable": true,
            "description": "Update the webhook URL."
          },
          "active": {
            "type": "boolean",
            "nullable": true,
            "description": "Enable or disable the webhook."
          },
          "chain_ids": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int64"
            },
            "nullable": true,
            "description": "Update the chain filter."
          },
          "transaction_type": {
            "allOf": [
              {
                "$ref": "#/components/schemas/TransactionType"
              }
            ],
            "nullable": true,
            "description": "ONLY for 'transactions' type webhooks. Update transaction type filter. Cannot be used with other webhook types.",
            "type": "string"
          },
          "counterparty": {
            "type": "string",
            "nullable": true,
            "description": "ONLY for 'transactions' type webhooks. Update counterparty filter."
          },
          "activity_type": {
            "allOf": [
              {
                "$ref": "#/components/schemas/ActivityType"
              }
            ],
            "nullable": true,
            "description": "ONLY for 'activities' type webhooks. Update activity type filter. Cannot be used with other webhook types.",
            "type": "string"
          },
          "asset_type": {
            "allOf": [
              {
                "$ref": "#/components/schemas/AssetType"
              }
            ],
            "nullable": true,
            "description": "Update asset type filter.",
            "type": "string"
          },
          "token_address": {
            "type": "string",
            "nullable": true,
            "description": "Update token address filter."
          }
        }
      },
      "AddressesList": {
        "type": "object",
        "properties": {
          "addresses": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "EVM address."
            }
          },
          "next_offset": {
            "type": "string",
            "description": "Cursor for pagination."
          }
        }
      },
      "ReplaceAddresses": {
        "type": "object",
        "required": [
          "addresses"
        ],
        "properties": {
          "addresses": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "EVM address."
            },
            "description": "New list of addresses to monitor. This replaces the existing list entirely."
          }
        }
      },
      "UpdateAddresses": {
        "type": "object",
        "properties": {
          "add_addresses": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "EVM address."
            },
            "description": "Addresses to add to the subscription list."
          },
          "remove_addresses": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "EVM address."
            },
            "description": "Addresses to remove from the subscription list."
          }
        }
      },
      "SvmBalanceItem": {
        "type": "object",
        "required": [
          "chain",
          "address",
          "amount"
        ],
        "properties": {
          "chain": {
            "type": "string",
            "description": "Name of blockchain of token"
          },
          "address": {
            "type": "string",
            "description": "Token contract address or blockchain name for native token"
          },
          "amount": {
            "type": "string",
            "description": "Amount of token owned in smallest unit. The amount field is based on uiAmountString from the account info to maintain backward compatibility."
          },
          "balance": {
            "type": "string",
            "description": "Formatted amount with decimals applied"
          },
          "raw_balance": {
            "type": "string",
            "description": "Raw balance that provides the raw amount divided by 10^decimals, which usually matches balance except when contract implements scaling logic."
          },
          "value_usd": {
            "type": "number",
            "description": "Current value of token owned, if available"
          },
          "program_id": {
            "type": "string",
            "description": "Program ID of the token (for SPL tokens)",
            "nullable": true
          },
          "decimals": {
            "type": "number",
            "description": "Decimals of token"
          },
          "total_supply": {
            "type": "string",
            "description": "Total supply of the token"
          },
          "name": {
            "type": "string",
            "description": "Name of token"
          },
          "symbol": {
            "type": "string",
            "description": "Symbol of token"
          },
          "uri": {
            "type": "string",
            "description": "URI to token metadata",
            "nullable": true
          },
          "price_usd": {
            "type": "number",
            "description": "Current price of token, if available"
          },
          "liquidity_usd": {
            "type": "number",
            "description": "Liquidity in USD, if available"
          },
          "pool_type": {
            "type": "string",
            "description": "Type of liquidity pool, if available",
            "nullable": true
          },
          "pool_address": {
            "type": "string",
            "description": "Address of liquidity pool, if available",
            "nullable": true
          },
          "mint_authority": {
            "type": "string",
            "description": "Mint authority address, if available",
            "nullable": true
          }
        }
      },
      "SvmBalancesResponse": {
        "type": "object",
        "required": [
          "wallet_address",
          "balances"
        ],
        "properties": {
          "processing_time_ms": {
            "type": "number",
            "description": "Time taken to process the request in milliseconds"
          },
          "wallet_address": {
            "type": "string",
            "description": "The queried wallet address"
          },
          "next_offset": {
            "type": "string",
            "description": "Pagination token for the next page of results"
          },
          "balances_count": {
            "type": "number",
            "description": "Total number of balances returned"
          },
          "balances": {
            "type": "array",
            "description": "Array of token balance objects",
            "items": {
              "$ref": "#/components/schemas/SvmBalanceItem"
            }
          }
        }
      },
      "SvmTransaction": {
        "type": "object",
        "required": [
          "address",
          "block_slot",
          "block_time",
          "chain"
        ],
        "properties": {
          "address": {
            "type": "string",
            "description": "Wallet address"
          },
          "block_slot": {
            "type": "number",
            "description": "Block's sequential index"
          },
          "block_time": {
            "type": "number",
            "description": "Timestamp of block creation (in microseconds)"
          },
          "chain": {
            "type": "string",
            "description": "Name of the blockchain"
          },
          "raw_transaction": {
            "type": "object",
            "description": "Raw transaction data from the RPC node at the time of ingestion"
          }
        }
      },
      "SvmTransactionsResponse": {
        "type": "object",
        "required": [
          "transactions"
        ],
        "properties": {
          "next_offset": {
            "type": "string",
            "description": "Pagination token for the next page of results"
          },
          "transactions": {
            "type": "array",
            "description": "Array of transaction objects",
            "items": {
              "$ref": "#/components/schemas/SvmTransaction"
            }
          }
        }
      },
      "GatewayErrorResponse": {
        "type": "object",
        "description": "Error response from the API gateway. Returned for authentication, permissions, rate-limiting, and quota errors.",
        "properties": {
          "error": {
            "type": "string",
            "description": "Error message."
          }
        },
        "required": [
          "error"
        ]
      },
      "ServiceMessageErrorResponse": {
        "type": "object",
        "description": "Error response from backend services that use a message field.",
        "properties": {
          "message": {
            "type": "string",
            "description": "Error message."
          }
        },
        "required": [
          "message"
        ]
      },
      "Collectibles_ErrorResponse": {
        "type": "object",
        "properties": {
          "error": {
            "type": "string",
            "description": "Error message.",
            "example": "invalid API Key"
          }
        },
        "required": [
          "error"
        ]
      },
      "TokenHolders_ErrorResponse": {
        "type": "object",
        "properties": {
          "error": {
            "$ref": "#/components/schemas/ErrorDetail"
          }
        },
        "required": [
          "error"
        ]
      },
      "SvmTransactions_ErrorResponse": {
        "type": "object",
        "description": "Error response from the SVM Transactions service.",
        "properties": {
          "message": {
            "type": "string",
            "description": "Error message."
          }
        },
        "required": [
          "message"
        ]
      }
    },
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Sim-Api-Key",
        "description": "API key for authentication. Obtain your key from the Dune dashboard at sim.dune.com."
      }
    }
  },
  "security": [
    {
      "ApiKeyAuth": []
    }
  ]
}