# 查询token持有人情况

**Repository Path**: yjstop/query-token-holders

## Basic Information

- **Project Name**: 查询token持有人情况
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-10
- **Last Updated**: 2025-09-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Solana代币持有人查询工具 (Vue3版本)

一个使用Vue3 + Element Plus构建的Solana代币合约持有人查询工具，可以查询前100持有人的持仓情况。

## ✨ 功能特性

- 🔍 **合约地址查询**: 输入Solana代币合约地址，自动查询持有人信息
- 📊 **持有人列表**: 显示前100个持有人的详细持仓信息
- 📱 **响应式设计**: 支持桌面端和移动端访问
- 🔗 **投资组合查看**: 点击持有人地址可查看其投资组合详情
- 📄 **分页显示**: 每页显示10条数据，支持分页浏览
- 💫 **现代化UI**: 使用Element Plus组件库，界面美观易用

## 🚀 快速开始

### 安装依赖
```bash
npm install
```

### 启动开发服务器
```bash
npm run dev
```

项目将在 `http://localhost:3000` 启动，并自动打开浏览器。

### 构建生产版本
```bash
npm run build
```

### 预览生产版本
```bash
npm run preview
```

## 🛠️ 技术栈

- **前端框架**: Vue 3
- **UI组件库**: Element Plus
- **构建工具**: Vite
- **HTTP客户端**: Axios
- **样式**: CSS3 (使用rpx单位)

## 🔧 跨域解决方案

项目通过Vite代理配置解决跨域问题：

```javascript
// vite.config.js
proxy: {
  '/api': {
    target: 'https://api-v2.solscan.io',
    changeOrigin: true,
    rewrite: (path) => path.replace(/^\/api/, ''),
    secure: false
  }
}
```

## 📡 API接口

### 持有人查询接口
```
GET /api/v2/token/holders?address={合约地址}&page_size=10&page={页码}
```

### 投资组合查询接口
```
GET /api/v2/account/tokenaccounts?address={用户地址}&page=1&page_size=10&type=token&hide_zero=true
```

## 📁 项目结构

```
├── index.html              # HTML入口文件
├── package.json            # 项目依赖配置
├── vite.config.js          # Vite配置文件
├── README.md               # 项目说明文档
├── 需求.md                 # 原始需求文档
└── src/
    ├── main.js             # Vue应用入口
    ├── App.vue             # 主应用组件
    ├── style.css           # 全局样式
    └── components/
        ├── SearchForm.vue  # 搜索表单组件
        └── TokenHolders.vue # 持有人列表组件
```

## 🎯 使用示例

1. 启动项目后，在浏览器中打开 `http://localhost:3000`
2. 输入示例合约地址: `A9ga87pYeS59BDrNn9J1c9cZYaZm32MnoBfVVX1Kbonk`
3. 点击"查询持有人"按钮
4. 查看持有人列表和详细信息
5. 点击持有人地址或"查看投资组合"按钮查看详情

## ⚠️ 注意事项

- 需要网络连接以访问Solscan API
- 合约地址必须是有效的Solana代币合约地址
- 数据来源于Solscan公开API，可能有访问频率限制
- 建议在Chrome、Firefox、Safari等现代浏览器中使用

## 🐛 常见问题

### Q: 启动项目时提示端口被占用
A: 修改 `vite.config.js` 中的端口号，或关闭占用端口的其他程序

### Q: 查询数据时出现跨域错误
A: 确保项目通过 `npm run dev` 启动，Vite代理会自动处理跨域问题

### Q: 页面样式显示异常
A: 确保已正确安装Element Plus依赖，并检查浏览器控制台是否有错误信息

## 📝 开发说明

本项目使用Vue3 Composition API开发，组件化设计，便于维护和扩展。所有API调用都通过代理转发，避免了跨域问题。