> ## 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 주소록 > Didit의 Travel Rule 주소록에 JSON 또는 CSV로 최대 10,000개 주소를 일괄 가져오세요. 주소 또는 주소 해시를 지원하며, 멱등성을 보장하고 행별 보고서를 제공합니다. 지갑 주소 가져오기 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 ko/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: >- JSON 또는 CSV 파일로 한 번의 호출에 최대 10,000개의 지갑을 Travel Rule 주소록에 추가합니다. 지갑은 주소 자체로 전송하거나 주소를 비공개로 유지하기 위해 소문자로 변환된 주소의 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: >- 열 이름이 행 필드 또는 해당 별칭으로 지정된 헤더 행이 포함된 최대 5MB 크기의 UTF-8 CSV 파일입니다. 빈 셀은 전송되지 않은 것으로 간주되며 가져오기에서 읽지 않는 열은 무시됩니다. 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개 이상의 행인 경우, 파일 크기가 5MB를 초과하는 경우, UTF-8 CSV가 아닌 경우, 헤더 행이 없거나 데이터 행이 없는 경우 등이 해당됩니다. 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: >- 가져올 지갑 1개: `address`, `address_hash` 또는 둘 다로 지정합니다. `walletAddress`, `walletAddressHash`, `destinationTag`, `externalUserId`뿐만 아니라 이 필드들의 camelCase 형식도 허용됩니다. properties: address: type: string maxLength: 128 description: '지갑 주소입니다. 별칭: `walletAddress`.' address_hash: type: string description: >- 소문자로 변환된 주소의 SHA-256(64자의 16진수 또는 44자의 base64 문자)입니다. 주소를 공개하지 않고 지갑을 등록하려면 이 값만 전송하십시오. `address`와 함께 전송하는 경우 해당 주소의 해시여야 합니다. 별칭: `walletAddressHash`. chain: type: string maxLength: 32 memo: type: string maxLength: 256 description: >- 대상 태그 또는 메모입니다. XRP: 대상 태그로, 0부터 4294967295까지의 정수입니다(JSON 숫자 허용). XLM: 최대 28바이트의 텍스트 메모, 64비트 id 또는 32바이트 16진수 해시입니다. EOS: 최대 256바이트입니다. ATOM: 최대 256자입니다. HBAR: 최대 100바이트입니다. Bitcoin, EVM, Solana, Tron, Litecoin, Bitcoin Cash, Dogecoin 및 Lightning 지갑은 메모를 지원하지 않으며, 포함 시 `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: >- Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.