> ## Documentation Index > Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt > Use this file to discover all available pages before exploring further. # Lấy danh tính ví > Tra cứu thông tin danh tính trên chuỗi của ví Solana, bao gồm tên miền và hồ sơ mạng xã hội. Mỗi yêu cầu tốn **100 tín dụng**. Yêu cầu gói trả phí. Các yêu cầu từ gói miễn phí sẽ trả về `403 Forbidden`. ## Tham số yêu cầu Địa chỉ ví Solana (được mã hóa base58) hoặc tên miền SNS/ANS (ví dụ: `toly.sol`, `miester.bonk`). Tính năng phân giải tên miền chỉ hỗ trợ mainnet. Mọi tên miền không phải `.sol` đều được coi là TLD tùy chỉnh của ANS — không có danh sách TLD cho phép cố định. ## OpenAPI ````yaml vi/openapi/wallet-api/openapi.yaml GET /v1/wallet/{wallet}/identity openapi: 3.0.3 info: title: Wallet API description: > REST API hiệu năng cao để truy vấn dữ liệu ví Solana, bao gồm số dư, lịch sử giao dịch, chuyển khoản và thông tin danh tính. ## Xác thực Mọi yêu cầu đều cần khóa API được truyền theo một trong hai cách: - Tham số truy vấn: `?api-key=YOUR_API_KEY` - Tiêu đề: `X-Api-Key: YOUR_API_KEY` version: 1.0.0 contact: name: Hỗ trợ API url: https://helius.dev servers: - url: https://api.helius.xyz description: Máy chủ sản xuất security: - ApiKeyQuery: [] - ApiKeyHeader: [] tags: - name: Danh tính description: Tra cứu danh tính ví và các địa chỉ đã biết - name: Số dư description: Truy vấn số dư token và NFT - name: Lịch sử description: Lịch sử giao dịch và thay đổi số dư - name: Chuyển khoản description: Hoạt động chuyển token - name: Cấp vốn description: Thông tin cấp vốn cho ví paths: /v1/wallet/{wallet}/identity: get: tags: - Danh tính summary: Lấy danh tính ví description: > Truy xuất thông tin danh tính của một ví đã biết (sàn giao dịch, giao thức, v.v.). Chấp nhận địa chỉ ví Solana hoặc tên miền TLD tùy chỉnh SNS (`.sol`) / ANS (ví dụ: `toly.sol`, `miester.bonk`). Chỉ phân giải tên miền trên mainnet. Phản hồi là đối tượng danh tính tiêu chuẩn cho **địa chỉ đã phân giải**. Endpoint này không đính kèm chỉ dấu tên miền (`inputDomain`) — hãy dùng `POST /v1/wallet/batch-identity` nếu cần liên kết đầu vào với đầu ra. Trả về `404` nếu ví không có mục danh tính hoặc không thể phân giải đầu vào là tên miền. Trả về `400` nếu đầu vào không phải địa chỉ hợp lệ cũng không phải tên miền hợp lệ, hoặc nếu đầu vào là tên miền được gửi tới một bản triển khai không phải mainnet. operationId: getWalletIdentity parameters: - $ref: '#/components/parameters/WalletOrDomain' responses: '200': description: Đã tìm thấy thông tin danh tính content: application/json: schema: $ref: '#/components/schemas/Identity' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '404': description: Không có thông tin danh tính hoặc không thể phân giải tên miền content: application/json: schema: $ref: '#/components/schemas/Error' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalError' components: parameters: WalletOrDomain: name: wallet in: path required: true description: > Địa chỉ ví Solana (được mã hóa base58) hoặc tên miền SNS/ANS (ví dụ: `toly.sol`, `miester.bonk`). Chỉ phân giải tên miền trên mainnet. Mọi tên miền không phải `.sol` đều được coi là TLD tùy chỉnh ANS — không có danh sách trắng TLD cố định. schema: type: string default: GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz examples: address: summary: Địa chỉ Solana value: GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz snsDomain: summary: Tên miền SNS (.sol) value: toly.sol ansDomain: summary: TLD tùy chỉnh ANS value: miester.bonk schemas: Identity: type: object properties: address: type: string description: Địa chỉ ví Solana example: HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664 type: type: string description: Loại thực thể example: exchange name: type: string description: Tên hiển thị example: Binance 1 category: type: string description: Phân loại danh mục example: Sàn giao dịch tập trung tags: type: array items: type: string description: Các thẻ phân loại bổ sung example: - Sàn giao dịch tập trung domainNames: type: array items: type: string description: >- Tất cả tên miền on-chain thuộc sở hữu của địa chỉ này, bao gồm SNS (.sol) và TLD tùy chỉnh ANS (.bonk, .wen, v.v.). Tên miền .sol yêu thích được đặt đầu tiên nếu đã thiết lập; các tên miền còn lại được sắp xếp theo thứ tự bảng chữ cái. Bị lược bỏ nếu ví không sở hữu tên miền nào. example: - toly.sol - kash.superteam required: - address - type - name - category - tags Error: type: object properties: error: type: string description: Thông báo lỗi example: Địa chỉ ví không hợp lệ code: type: integer description: Mã trạng thái HTTP example: 400 details: type: string description: Chi tiết bổ sung về lỗi example: '''invalid-address'' không phải là địa chỉ Solana hợp lệ' required: - error - code responses: BadRequest: description: Tham số yêu cầu không hợp lệ content: application/json: schema: $ref: '#/components/schemas/Error' example: error: Địa chỉ ví không hợp lệ code: 400 details: '''invalid-address'' không phải là địa chỉ Solana hợp lệ' Unauthorized: description: Thiếu khóa API hoặc khóa API không hợp lệ content: application/json: schema: $ref: '#/components/schemas/Error' example: error: Cần có khóa API. Truyền qua ?api-key=xxx hoặc tiêu đề X-Api-Key code: 401 RateLimited: description: Đã vượt quá giới hạn tốc độ. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: RATE_LIMIT_EXCEEDED code: 429 details: Quá nhiều yêu cầu. Hãy thử lại sau 2 giây. InternalError: description: Lỗi máy chủ tạm thời. Có thể thử lại với cơ chế lùi theo cấp số nhân. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: INTERNAL_ERROR code: 500 details: Đã xảy ra lỗi không mong muốn. Vui lòng thử lại. securitySchemes: ApiKeyQuery: type: apiKey in: query name: api-key description: Khóa API được truyền dưới dạng tham số truy vấn ApiKeyHeader: type: apiKey in: header name: X-Api-Key description: Khóa API được truyền trong tiêu đề yêu cầu ````