> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Wallet-Adressen importieren: Travel-Rule-Adressbuch-API > Didit importiert bis zu 10,000 Wallets ins Travel-Rule-Adressbuch – aus JSON oder CSV, per Adresse oder Hash, idempotent, mit Bericht pro Zeile. Prompt für die API zum Importieren von Wallet-Adressen Prompt in die Zwischenablage kopieren \

\`Import many wallets into the application's Travel Rule address book in one call, as JSON or as a CSV file.

Endpoint:
POST https://verification.didit.me/v3/travel-rule/wallet-addresses/import/

Authentication:
Use the x-api-key header with my Didit API key.

Request body, one of:
\- application/json: {"entries": [row, ...]} or a bare JSON array of rows.
\- multipart/form-data: a "file" field holding a UTF-8 CSV of at most 5 MB with a header row naming the columns.
At most 10,000 rows either way.

Row fields (every one optional, but each row needs address, address_hash or both):
\{
"address": "0xBeneficiaryWallet01",      // the wallet address (alias: walletAddress)
"address_hash": "4f7d...3f2e",           // SHA-256 of the lowercased address, 64 hex or 44 base64 characters (alias: walletAddressHash)
"chain": "ETH",
"memo": "104729",                        // destination tag or memo on XRP, XLM, EOS, ATOM, HBAR (alias: destinationTag)
"holder_name": "Ana Diaz",
"holder_vendor_data": "user-042",        // your id for the holder (alias: externalUserId)
"entity_type": "individual",             // individual or company
"label": "Main deposit wallet",
"owner_type": "customer",                // customer, internal or vasp
"travel_address": "ta...",
"self_declared": false                   // only when your settings allow self-declaration
}

Behavior:
\- Send address_hash alone to register a wallet without disclosing its address. Sent with address, it must be that address's hash.
\- Idempotent: a wallet already in the book (same address or hash, chain and memo) is reported as "existing" and left untouched, so the same file can be sent again.
\- A row that repeats an earlier row of the same import is "duplicate" and names that row.
\- Each row is validated on its own, so one bad row never fails the others.
\- An entry imported by its hash only matches transfers to that address, and can be proven with the wallet-ownership widget like any other entry.
\- In a CSV, an empty cell counts as not sent and columns the import does not read are ignored.

What to read from the response:
\- 200 when no row failed, 207 when at least one did.
\- total, created, existing, duplicate, failed - the counts.
\- rows[] - one result per row in the order sent: row (from 1), status, entry_id, errors, duplicate_of_row.

Failure modes:
\- 400 - both entries and a file, or neither; more than 10,000 rows; a file over 5 MB, not UTF-8 CSV, or without a header row or rows.
\- 401 - missing or malformed x-api-key.

Full guide: /transaction-monitoring/travel-rule#importing-wallets-in-bulk.`

\
Einfügen in ## OpenAPI ````yaml de/openapi-25.json POST /v3/travel-rule/wallet-addresses/import/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API für Ausweisverifizierung. Authentifizierung über den x-api-key-Header. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/travel-rule/wallet-addresses/import/: post: tags: - Travel Rule summary: Wallet-Adressen massenweise importieren description: >- Fügen Sie Ihrem Travel-Rule-Adressbuch bis zu 10.000 Wallets in einem Aufruf als JSON oder CSV-Datei hinzu. Eine Wallet kann über ihre Adresse, über den SHA-256-Hash ihrer in Kleinbuchstaben konvertierten Adresse (`address_hash`), um die Adresse geheim zu halten, oder beides übermittelt werden. Der Import ist idempotent: Eine Wallet, die bereits im Adressbuch vorhanden ist, wird als `existing` gemeldet und unverändert belassen, sodass dieselbe Datei erneut gesendet werden kann. Jede Zeile wird einzeln validiert, sodass eine fehlerhafte Zeile niemals die anderen beeinträchtigt. Eine nur über ihren Hash importierte Wallet stimmt nur mit Transfers an diese Adresse überein und kann wie jeder andere Eintrag über das Wallet-Ownership-Widget nachgewiesen werden. operationId: importTravelRuleWalletAddresses requestBody: required: true content: application/json: schema: oneOf: - type: object required: - entries properties: entries: type: array minItems: 1 maxItems: 10000 items: $ref: '#/components/schemas/WalletAddressImportRow' - type: array minItems: 1 maxItems: 10000 items: $ref: '#/components/schemas/WalletAddressImportRow' example: entries: - address: 0xBeneficiaryWallet01 chain: ETH holder_name: Ana Diaz holder_vendor_data: user-042 - address_hash: >- 4f7d2e1c9b8a7f6e5d4c3b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f2e chain: bitcoin holder_vendor_data: user-043 - address: rExchangeSharedAddress01 chain: XRP memo: '104729' holder_name: Ana Diaz multipart/form-data: schema: type: object required: - file properties: file: type: string format: binary description: >- Eine UTF-8-CSV-Datei mit maximal 5 MB und einer Header-Zeile, die die Spalten benennt (die Feldnamen oder ihre Aliase). Leere Zellen gelten als nicht gesendet; Spalten, die der Import nicht liest, werden ignoriert. responses: '200': description: >- Jede Zeile wurde erstellt, war bereits vorhanden oder ist eine Wiederholung einer früheren Zeile. content: application/json: schema: $ref: '#/components/schemas/WalletAddressImportReport' example: total: 3 created: 2 existing: 1 duplicate: 0 failed: 0 rows: - row: 1 status: existing entry_id: 11111111-2222-3333-4444-555555555555 errors: {} duplicate_of_row: null - row: 2 status: created entry_id: 22222222-3333-4444-5555-666666666666 errors: {} duplicate_of_row: null - row: 3 status: created entry_id: 33333333-4444-5555-6666-777777777777 errors: {} duplicate_of_row: null '207': description: >- Mindestens eine Zeile ist fehlgeschlagen; die anderen wurden importiert. Jede fehlgeschlagene Zeile benennt ihre Fehler. content: application/json: schema: $ref: '#/components/schemas/WalletAddressImportReport' example: total: 2 created: 1 existing: 0 duplicate: 0 failed: 1 rows: - row: 1 status: created entry_id: 44444444-5555-6666-7777-888888888888 errors: {} duplicate_of_row: null - row: 2 status: failed entry_id: null errors: address: - Send address, address_hash or both. duplicate_of_row: null '400': description: >- Die Anfrage selbst kann nicht gelesen werden: sowohl `entries` als auch eine `file` oder keines von beiden angegeben; mehr als 10.000 Zeilen; eine Datei über 5 MB, keine UTF-8-CSV, ohne Kopfzeile oder ohne Zeilen. content: application/json: schema: type: object example: file: - At most 10000 rows per import. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl (JSON) source: >- curl -X POST https://verification.didit.me/v3/travel-rule/wallet-addresses/import/ \ -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \ -d '{"entries": [{"address": "0xBeneficiaryWallet01", "chain": "ETH", "holder_name": "Ana Diaz"}, {"address": "rExchangeSharedAddress01", "chain": "XRP", "memo": "104729"}]}' - lang: curl label: curl (CSV) source: >- curl -X POST https://verification.didit.me/v3/travel-rule/wallet-addresses/import/ \ -H 'x-api-key: YOUR_API_KEY' \ -F 'file=@wallets.csv;type=text/csv' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.travel_rule.wallet_addresses.bulk_import( body={ "entries": [{ "address": "0xBeneficiaryWallet01", "chain": "ETH", "holder_name": "Ana Diaz", "holder_vendor_data": "user-042", }, { "address_hash": "4f7d2e1c9b8a7f6e5d4c3b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f2e", "chain": "bitcoin", "holder_vendor_data": "user-043", }, { "address": "rExchangeSharedAddress01", "chain": "XRP", "memo": "104729", "holder_name": "Ana Diaz", }], }, ) print(result) - lang: javascript label: Node.js source: |- import Didit, { fileFromPath } from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.travelRule.walletAddresses.bulkImport({ file: await fileFromPath("wallet-addresses.csv"), }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.TravelRule.WalletAddresses.BulkImport(ctx, didit.TravelRuleWalletAddressesBulkImportParams{\n\tFile: didit.Some(didit.FileFromPath(\"wallet-addresses.csv\")),\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import java.nio.file.Path; import me.didit.Didit; import me.didit.types.TravelRuleWalletAddressesBulkImportParams; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.travelRule().walletAddresses().bulkImport(TravelRuleWalletAddressesBulkImportParams.builder() .file(Path.of("wallet-addresses.csv")) .build()); System.out.println(result); - lang: php label: PHP source: |- travelRule->walletAddresses->bulkImport([ 'file' => File::fromPath('wallet-addresses.csv'), ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.travel_rule.wallet_addresses.bulk_import( body: { entries: [{ address: "0xBeneficiaryWallet01", chain: "ETH", holder_name: "Ana Diaz", holder_vendor_data: "user-042", }, { address_hash: "4f7d2e1c9b8a7f6e5d4c3b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f2e", chain: "bitcoin", holder_vendor_data: "user-043", }, { address: "rExchangeSharedAddress01", chain: "XRP", memo: "104729", holder_name: "Ana Diaz", }], } ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.TravelRule.WalletAddresses.BulkImportAsync(new TravelRuleWalletAddressesBulkImportParams { File = FileUpload.FromPath("wallet-addresses.csv"), }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: WalletAddressImportRow: type: object description: >- Eine zu importierende Wallet: anhand ihrer `address`, ihres `address_hash` oder beidem. Die camelCase-Formen dieser Felder werden ebenfalls akzeptiert, ebenso wie `walletAddress`, `walletAddressHash`, `destinationTag` und `externalUserId`. properties: address: type: string maxLength: 128 description: 'Die Adresse. Alias: `walletAddress`.' address_hash: type: string description: >- SHA-256 der in Kleinbuchstaben geschriebenen Adresse als 64 Hex-Zeichen oder 44 Base64-Zeichen. Senden Sie diesen Wert allein, um eine Wallet zu registrieren, ohne deren Adresse offenzulegen; wird er zusammen mit `address` gesendet, muss er der Hash dieser Adresse sein. Alias: `walletAddressHash`. chain: type: string maxLength: 32 memo: type: string maxLength: 256 description: >- Das Ziel-Tag oder Memo. XRP: ein Ziel-Tag, eine ganze Zahl von 0 bis 4294967295 (eine JSON-Zahl wird akzeptiert). XLM: ein Text-Memo von bis zu 28 Bytes, eine 64-Bit-ID oder ein 32-Byte-Hash in Hex. EOS: bis zu 256 Bytes. ATOM: bis zu 256 Zeichen. HBAR: bis zu 100 Bytes. Wallets für Bitcoin, EVM, Solana, Tron, Litecoin, Bitcoin Cash, Dogecoin und Lightning akzeptieren kein Memo: wird dennoch eines übergeben, führt dies zu einem `400`. holder_name: type: string maxLength: 255 holder_vendor_data: type: string maxLength: 255 description: 'Ihre interne Kennung für den Inhaber. Alias: `externalUserId`.' entity_type: type: string enum: - individual - company default: individual label: type: string maxLength: 255 owner_type: type: string enum: - customer - internal - vasp default: customer travel_address: type: string maxLength: 512 self_declared: type: boolean default: false description: >- Erstellt den Eintrag direkt als durch Eigenerklärung verifiziert, wenn Ihre Einstellungen dies erlauben. WalletAddressImportReport: type: object description: >- Was mit jeder Zeile eines Imports passiert ist, in der gesendeten Reihenfolge. properties: total: type: integer created: type: integer existing: type: integer duplicate: type: integer failed: type: integer rows: type: array items: type: object properties: row: type: integer description: Die Zeilennummer, beginnend bei 1. status: type: string enum: - created - existing - duplicate - failed description: >- `created`: zum Adressbuch hinzugefügt. `existing`: Die Wallet befindet sich bereits im Adressbuch und blieb unverändert. `duplicate`: wiederholt eine frühere Zeile dieses Imports. `failed`: siehe `errors`. entry_id: type: string format: uuid nullable: true description: >- Der Adressbucheintrag, den die Zeile erstellt oder gefunden hat. errors: type: object description: Feldfehler einer `failed`-Zeile; andernfalls leer. duplicate_of_row: type: integer nullable: true description: Bei einer `duplicate`-Zeile die Zeile, die sie wiederholt. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.