Vai al contenuto principale

Integrazione - File modello Waltio

Come importare le tue transazioni da piattaforme non supportate utilizzando il modello di file Waltio?

📝 Descrizione

Questo tutorial spiega come aggiungere le tue transazioni utilizzando il formato di file Waltio se la tua piattaforma di exchange o il tuo portafoglio crypto non sono supportati nativamente. Scarica il modello o consulta un file Waltio d'esempio compilato per guidarti in base al tipo di transazione.


⚠️ Raccomandazioni

  • Per aggiungere il tuo file modello su Waltio, seleziona sempre "Waltio" nell'elenco Aggiungi account.

  • Presta molta attenzione al formato dei dati per ogni colonna e al modo in cui inserisci le informazioni. È necessario rispettare la convenzione di scrittura specificata in questo articolo per evitare errori.

  • In caso di dubbio, copia il prompt in fondo all'articolo e genera il tuo file con Gemini.

📂 Passaggi per compilare manualmente il modello Waltio

  1. Scarica e apri il modello: Scarica il file modello e aprilo nel tuo software per fogli di calcolo.

  2. Seleziona il tipo di transazione: Nella colonna A (Type), seleziona il tipo di transazione. È possibile scegliere solo tra:

    • Deposit

    • Trade

    • Withdrawal

  3. Inserisci la data: Inserisci la data della transazione nella colonna B (Date) utilizzando il seguente formato: 31/10/2008 00:00:00

  4. Inserisci importi e token:

    • Per un Deposito (Deposit) o uno Scambio (Trade): Inserisci l'importo ricevuto nella colonna Received amount e il token ricevuto nella colonna Currency or token sent.

    • Per un Prelievo (Withdrawal) o uno Scambio (Trade): Inserisci l'importo inviato nella colonna Sent amount e il token inviato nella colonna Currency or token sent.

    • Nota: Gli importi inviati devono essere al netto delle commissioni. Esempio: Se hai effettuato un prelievo di 10 BCH con una commissione di 0,1 BCH, inserisci 9.90 nella colonna Sent amount e 0.1 nella colonna Fee.

  5. Inserisci le commissioni Indica l'importo della commissione nella colonna Fee e il relativo token nella colonna Currency or token des Fee, se applicabile.

  6. Inserisci il nome della piattaforma e i dettagli

    • Indica il nome della piattaforma in MAIUSCOLO nella colonna I (Exchange / Platform) (ad es. BINANCE). Se il nome è composto da due parole, uniscile con un trattino basso (ad es. COINBASE_PRO).

    • Inserisci una descrizione nella colonna Description e un'etichetta nella colonna Label, se desiderato. Queste informazioni sono opzionali e possono essere aggiunte anche direttamente dal tuo account Waltio.

  7. Caricare il file su Waltio: Aggiungi il tuo file modello cliccando su questo link.

💡 Informazioni aggiuntive

  • Formattazione dei dati grezzi: Inserisci i dati come valori grezzi, senza formule di calcolo. Quando incolli i valori, seleziona "Incolla con formattazione di destinazione" per evitare errori.

  • Visualizzazione del fuso orario: I timestamp devono essere inseriti in GMT. Nell'interfaccia di Waltio si adatteranno automaticamente in base alla tua posizione di connessione. Esempio: Una transazione aggiunta alle 14:00 GMT verrà visualizzata come le 15:00 se ti connetti da Parigi.

  • Transazioni di trading a margine:

    • Se la tua operazione è stata redditizia: Aggiungi una transazione Deposit con l'etichetta Derivative product gain.

    • Se la tua operazione ha registrato una perdita: Aggiungi una transazione Withdrawal con l'etichetta Loss of derivative product.

  • Limite di transazioni: Ogni file è limitato a 10.000 transazioni. I file che contengono più di 10.000 righe non verranno letti da Waltio.

  • Formato avanzato: Puoi utilizzare il formato di file avanzato di Waltio se devi fornire dettagli aggiuntivi (come il fuso orario o l'hash della transazione).

👉 Riferimento dei nomi delle piattaforme supportate

Compila la colonna I (Exchange / Platform) utilizzando esattamente gli identificativi della piattaforma elencati di seguito:

Identificativi piattaforma

AKT_IO

ALGORAND

ASCENDEX

AVALANCHE

BINANCE

BITCOIN_AVENUE

BITFINEX

BITMART

BITMEX

BITPANDA

BITSTAMP

BITRUE

BITTREX

BITVAVO

BLOCKFI

BYBIT

CAKEDEFI

CELO

CELSIUS

CEX_IO

COINBASE

COINBASE_PRIME

COINBASE_PRO

COINBENE

COINEX

COINHOUSE

COINLIST

COINLIST_PRO

COINMERCE

COINMETRO

COINTRACKING

COINZOOM

COSS

COSMOSTATION

CREX24

CRONOS

CRYPTOPAY

CRYPTO_COM

ETORO

FANTOM

FEEL_MINING

FTX

GATE_IO

HITBTC

HOTBIT

HUOBI

JUST_MINING

KRAKEN

KUCOIN_FUTURES

KUCOIN

LEDGER_LIVE

LIQUID

LIVECOIN

LYDIA

MAIAR

MOONBEAM

MOONRIVER

NEXO

NICEHASH

OKEX

PAYEER

PAYMIUM

POLONIEX

PROBIT

RAINBOW

REVOLUT

SOLANA

STACKINSAT

SWISSBORG

TEZOS

UPHOLD

VIRWOX

WALLET_ACALA

WALLET_ARBITRUM

WALLET_ASTAR

WALLET_BLOCKCHAIN_COM

WALLET_BCH

WALLET_BSC

WALLET_BSV

WALLET_BTC

WALLET_CARDANO

WALLET_CENTRIFUGE

WALLET_CLOVERS

WALLET_COSMOS

WALLET_CRUST_SHADOW

WALLET_DASH

WALLET_DOGE

WALLET_ECASH

WALLET_ERD

WALLET_ETH

WALLET_EXODUS

WALLET_GROESTLCOIN

WALLET_HARMONY

WALLET_HECO

WALLET_KARURA

WALLET_INTERLAY

WALLET_KUSAMA

WALLET_LTC

WALLET_MATIC

WALLET_MINA

WALLET_NEAR

WALLET_OPTIMISM

WALLET_OSMOSIS

WALLET_PARALLEL

WALLET_PHALA

WALLET_POLKADEX

WALLET_POLKADOT

WALLET_RIPPLE

WALLET_RONIN

WALLET_RSK

WALLET_SAKURA

WALLET_STELLAR

WALLET_TERRA

WALLET_TERRA_2

WALLET_TREZOR

WALLET_TRON

WALLET_TRUST

WALLET_UNIQUE

WALLET_VECHAIN

WALLET_XDAI

WALLET_YOROI

WALLET_ZCASH

WALLET_ZERION

WALLET_ZKSYNC

WIREX

YIELD

YOUHODLER

ZAPPER

ZEBITEX

ZELCORE

💡 Prompt IA per generare il modello Waltio

Usa questo prompt in Gemini per convertire automaticamente il tuo file di transazioni in un modello compatibile con Waltio.

Prompt IA Generativa:

**Identity**
You are a Crypto Data Migration Expert specializing in standardizing transaction files for the Waltio platform. Your role is to analyze CSV or XLSX exports from heterogeneous crypto platforms (natively unsupported exchanges) and convert them with absolute precision into a ready-to-use Excel file. **Goal**
Transform raw files into an Excel file (`.xlsx` or `.xls`) that is 100% compatible with Waltio, cleaned, and immediately importable. You must provide a downloadable file to guarantee data integrity for large volumes.**Instructions****Step 1: Analysis & Mapping**
 - Upon receiving the raw file or data, analyze the columns.
- Propose a clear mapping to the user:
- Expected Date Format: `DD/MM/YYYY HH:MM`
- Tickers & Platform Name: In UPPERCASE
- Qualification of Type (`Deposit`, `Withdrawal`, `Trade`) and assignment of the appropriate **official Waltio Label** according to the list below.
- Wait for explicit user validation before processing.**Step 2: Strict Taxonomy of Waltio Labels**
When filling the `Label` column, you must **STRICTLY** use one of the following official labels:
 
**A. Allowed labels for DEPOSITS:**
- Salary
- Donation
- Cashback
- Buying crypto
- Mining
- Collateral repayment
- Unstaking
- Scam
- Airdrop
- Masternode and staking
- ICO
- Fork
- Derivative product gain
- Other gain
- Loan
- Swap
- Withdrawal of liquidity
- Transfer between accounts**B. Allowed labels for WITHDRAWALS:**
- Payment
- Staking
- Donation
- Fee
- Adding liquidity
- Collateralization
- Loss of derivative product
- Transfer between accounts
- ICO
- NFT
- Swap
- Lost or Stolen
- Other loss
- Other withdrawal**TRADES cannot have a label.****Step 3: Filtering & Technical Processing (Python)**
Once mapping is validated, **SYSTEMATICALLY USE the Python code interpreter** to execute the cleaning script according to these rules:1. **FILTER 1 - Ignore 100% FIAT transactions:** Exclude all rows involving ONLY fiat currencies (e.g., EUR Deposit, USD Withdrawal, EUR -USD Exchange, direct non-crypto FIAT purchase). A transaction is kept only if at least one crypto asset is involved.
2. **FILTER 2 - Ignore internal transfers:** Remove all movements internal to the platform (e.g., Transfer from Spot to Earn, Futures, Funding, Margin, etc.).
3. **Cleaning & Formatting:**
   - The file must not exceed 10,000 rows. If it exceeds, generate a second file with remaining rows.
   - Clean amounts: strictly numerical values (no `$`, `€` symbols, or spaces).
   - Dates: `DD/MM/YYYY HH:MM` (remove seconds).
   - Tickers and Exchange: UPPERCASE (e.g., `BTC`, `ETH`, `BINANCE`, `BITRUE`).**Step 4: File Generation & Tag Restitution**
- Generate and save the Excel file as `export_waltio_[platform]_[start-date]_[end-date].xlsx` using pandas or openpyxl.
- **MANDATORY OUTPUT RULE:** After running the Python script, strictly respond including the generated system file tag (`[file-tag: code-generated-file-...]`).**Rules (Excel File Structure)**
- **DIRECT ROW 1:** Row 1 of the Excel sheet must EXCLUSIVELY contain official Waltio column headers.
- **NO POLLUTION:** Strictly forbidden to add titles, file names, summaries, or text above Row 1. Row 1 is the header, Row 2 starts directly with the first transaction.
- **MAXIMUM 10,000 ROWS PER FILE:** Strictly forbidden to exceed 10,000 rows per generated file.**Official Waltio Columns (Row 1 of Excel File)**
`Type` | `Date` | `Received amount` | `Currency or token received` | `Sent amount` | `Currency or token sent` | `Fee` | `Currency or token des Fee` | `Exchange / Platform` | `Description` | `Label`
Hai ricevuto la risposta alla tua domanda?