> ## 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. # API импорта адресов кошельков: адресная книга Travel Rule > Массовый импорт до 10 000 кошельков в адресную книгу Travel Rule из JSON или CSV, по адресу или хэшу адреса, идемпотентно, с отчётом по каждой строке от Didit. Промпт API для импорта адресов кошельков Скопировать промпт в буфер обмена \

\`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.`

\
Вставьте в ## OpenAPI ````yaml ru/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 верификации личности. Аутентификация выполняется с помощью заголовка x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/travel-rule/wallet-addresses/import/: post: tags: - Travel Rule summary: Массовый импорт адресов кошельков description: >- Добавьте до 10,000 кошельков в адресную книгу Travel Rule за один вызов в формате JSON или CSV-файла. Кошелек можно передать по его адресу, по хэшу SHA-256 адреса в нижнем регистре (`address_hash`) для сохранения конфиденциальности адреса, или обоими способами. Импорт идемпотентен: кошелек, уже присутствующий в книге, отмечается как `existing` и остается без изменений, поэтому тот же файл можно отправить повторно. Каждая строка валидируется отдельно, поэтому одна некорректная строка не приводит к сбою остальных. Кошелек, импортированный только по хэшу, сопоставляется только с переводами на этот адрес и может быть подтвержден с помощью виджета владения кошельком, как и любая другая запись. 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: >- CSV-файл в кодировке UTF-8 размером не более 5 МБ со строкой заголовка с названиями столбцов (поля строки или их псевдонимы). Пустые ячейки считаются непереданными; столбцы, которые не считываются импортом, игнорируются. responses: '200': description: >- Каждая строка была создана, уже находилась в книге или повторяла более раннюю строку. 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: >- Как минимум для одной строки произошла ошибка; остальные были импортированы. Для каждой строки с ошибкой указаны её ошибки. 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: >- Сам запрос не может быть прочитан: переданы одновременно `entries` и `file` либо не передано ни то, ни другое; более 10,000 строк; файл размером более 5 MB, файл CSV не в кодировке UTF-8, без строки заголовков или без строк данных. 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: >- Один кошелёк для импорта: по его `address`, его `address_hash` или обоим полям. Формы этих полей в camelCase также принимаются, как и `walletAddress`, `walletAddressHash`, `destinationTag` и `externalUserId`. properties: address: type: string maxLength: 128 description: 'Адрес кошелька. Псевдоним: `walletAddress`.' address_hash: type: string description: >- SHA-256 адреса в нижнем регистре в виде 64 шестнадцатеричных символов или 44 символов base64. Передайте только его, чтобы зарегистрировать кошелёк без раскрытия его адреса; при передаче вместе с `address` он должен являться хешем этого адреса. Псевдоним: `walletAddressHash`. chain: type: string maxLength: 32 memo: type: string maxLength: 256 description: >- Тег назначения или memo. XRP: тег назначения, целое число от 0 до 4294967295 (принимается число JSON). XLM: текстовое memo до 28 байт, 64-битный id или 32-байтный хеш в hex. EOS: до 256 байт. ATOM: до 256 символов. HBAR: до 100 байт. Для кошельков Bitcoin, EVM, Solana, Tron, Litecoin, Bitcoin Cash, Dogecoin и Lightning memo не используется: передача memo вызовет ошибку `400`. holder_name: type: string maxLength: 255 holder_vendor_data: type: string maxLength: 255 description: 'Ваш внутренний идентификатор владельца. Псевдоним: `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: >- Создать запись, уже верифицированную на основе самодекларации, если это разрешено вашими настройками. WalletAddressImportReport: type: object description: Что произошло с каждой строкой импорта в порядке отправки. 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: Номер строки, начиная с 1. status: type: string enum: - created - existing - duplicate - failed description: >- `created`: добавлен в книгу. `existing`: кошелёк уже есть в книге и оставлен без изменений. `duplicate`: повторяет более раннюю строку этого импорта. `failed`: см. `errors`. entry_id: type: string format: uuid nullable: true description: Запись адресной книги, которую создала или нашла эта строка. errors: type: object description: >- Ошибки полей строки со статусом `failed`; в противном случае пусто. duplicate_of_row: type: integer nullable: true description: >- В строке со статусом `duplicate`: строка, которую она повторяет. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.