LogoLogo
BlogCase StudiesLogin
  • welcome
    • About Addressable
  • Solution Suite
    • Targeting
      • Managing Campaigns
      • Creating a Twitter Campaign
      • Creating a Display Campaign
      • Campaign Performance
      • Ads Specifications
    • Audiences
      • Audience Manager
      • Audience Builder
      • Audience Dashboard
    • Insights & Analytics
      • How Attribution Works
      • Marketing Channels Classification
      • Metrics Glossary
  • Integrations
    • Data Sources & Integrations
      • Engagement Data Tracking
      • Performance Data Tracking
      • Import Wallet List
    • Twitter (X) Integration
    • Reddit Integration
    • Addressable Pixel
    • AppsFlyer Integration
  • APIs
    • Events API (server-to-server)
    • Audience Anywhere
Powered by GitBook
On this page
  • Overview
  • How to upload a file
  • File Requirements
  • Handling Errors
  • Create Audiences

Was this helpful?

Export as PDF
  1. Integrations
  2. Data Sources & Integrations

Import Wallet List

A guide for uploading wallet lists to Addressable

Last updated 2 months ago

Was this helpful?

Overview

Using Import Wallet List users can upload their own wallet lists directly through the interface. Uploaded lists will be immediately available in the Audience Builder for targeting.

How to upload a file

  1. Navigate to the Wallet List Upload section.

  2. Click on Upload File and select your CSV, XLS, or XLSX file.

  3. The system will validate the file based on the above requirements.

  4. Upon successful upload, the wallet list will be available in Audience Builder for targeting.

File Requirements

Refer to the bekow file template for correct formatting:

sample_wallet_list.csv
0x000cD27F10dFFAC73201258EAA3925c0452051A0
0x1B3d2f8C345A1A67F8E2d5E4A3E905A2D1C2A71E
0x2E59FF8c41E87B0FcD6A27eF3E1C5A1c3D02E42F
0x3F5CE5FBFe3E9af3971dD833D26BA9b5C936f0bE
0x4A5fF8bBA2f6D4E5C785e6c8D1A5E9A3F52bA0B6
0x5b6E54fF28B5B6a9C8B3d2E6F8C7D4A3B6A1A8C2
0x6C7A3F5bE8D3C2B6A1F4E5D8B3C2F8A7D4B6A5E9
0x7D8B3C2F5E6A7D4B6A1F8C7A3F5E8D3C2B6A1F4
0x8E9A3F5B6A7D4B6A1F8C7A3F5E8D3C2B6A1F4E5
0x9F5E8D3C2B6A1F4E5D8B3C2F8A7D4B6A5E9A3F5

Supported File Formats

  • CSV, XLS, or XLSX

  • Max File Size: 50MB

  • Max Wallets per File: 500K

Supported Addresses

  • Only EVM-compatible wallet addresses are supported (e.g., 0x000cD27F10dFFAC73201258EAA3925c0452051A0).

  • ENS addresses are not supported.

  • Smart contract addresses will be ignored.

  • Addresses from unsupported chains will be ignored.

File Structure

  • The file must not contain headers.

  • Only the first column will be searched for wallet addresses.

Handling Errors

  • If there are errors in the file, a warning icon (triangle) will appear.

  • Hover over the triangle to download the error log.

  • The error log will specify:

    • Row number where the issue occurred

    • Input received

    • Reason for the error (error message)

  • If the file contains both valid and invalid addresses, the upload status will be marked as "Incomplete".

  • Download the error log to review and correct any issues.


Create Audiences

To create a new audience out of an existing list, press the "create as audience" button

  • When saving an audience, only wallets from supported chains are stored.

  • This means you may see fewer addresses in Audience Builder than were originally uploaded.

Wallet lists appear in the on-chain categories section in the Audience Builder: