> ## 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의 지갑 주소록 항목을 조회합니다. INTERNAL 경로 Travel Rule 이체가 참조하는 항목과 소유권 인증 상태를 확인할 수 있습니다.

지갑 주소 목록 조회 API 프롬프트
프롬프트를 클립보드에 복사

<pre>
  \`List the application's Travel Rule wallet address book - the registry of wallets you control that inbound INTERNAL-rail transfers resolve against.

  Endpoint:
  GET [https://verification.didit.me/v3/travel-rule/wallet-addresses/](https://verification.didit.me/v3/travel-rule/wallet-addresses/)

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

  Query parameters:

  * limit / offset - pagination; count/next/previous describe the page window.

  What to read from each entry:

  * uuid - the entry id, used in PATCH/DELETE /v3/travel-rule/wallet-addresses/{entry_uuid}/.
  * address, chain - the registered wallet.
    When a transfer names a chain, sunrise registration, the INTERNAL rail and the outbound TRP travel-address lookup match an entry only when its chain equals the transfer's chain (case-insensitive) or the entry's chain is blank.
    Chain names are not translated, so an entry with chain "ethereum" does not match a transfer with chain "ETH".
    Inbound TRP inquiries and ownership confirmation ignore the chain and match by address (an inbound TRP inquiry that carries no address matches a verified entry by holder\_name instead).
  * holder\_name / holder\_vendor\_data / entity\_type - the wallet holder, used for the beneficiary name match.
  * travel\_address - the counterparty VASP's travel address for this wallet, when known; it lets outbound transfers of an asset TRP carries (BTC, ETH, and USDC on a named network) to this wallet route over TRP.
  * is\_ownership\_verified - whether control of this address has been proven (wallet-ownership widget or self-declaration). Verified entries let inbound transfers skip UNCONFIRMED\_OWNERSHIP.

  Full guide: /transaction-monitoring/travel-rule#wallet-address-book.\`
</pre>

붙여넣을 곳


## OpenAPI

````yaml ko/openapi-25.json GET /v3/travel-rule/wallet-addresses/
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/:
    get:
      tags:
        - Travel Rule
      summary: 지갑 주소록 항목 목록 조회
      description: 애플리케이션의 Travel Rule 지갑 주소록의 페이지 단위 목록(최신순)입니다.
      operationId: listTravelRuleWalletAddresses
      parameters:
        - name: limit
          in: query
          schema:
            type: integer
            default: 50
            minimum: 1
        - name: offset
          in: query
          schema:
            type: integer
            default: 0
            minimum: 0
      responses:
        '200':
          description: 페이지네이션된 지갑 주소록 항목 목록입니다.
          content:
            application/json:
              schema:
                type: object
                properties:
                  count:
                    type: integer
                  next:
                    type: string
                    nullable: true
                  previous:
                    type: string
                    nullable: true
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/WalletAddressEntry'
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: curl
          label: curl
          source: >-
            curl -X GET
            https://verification.didit.me/v3/travel-rule/wallet-addresses/ \
              -H 'x-api-key: YOUR_API_KEY'
        - lang: python
          label: Python
          source: |-
            from didit import Didit

            # Reads DIDIT_API_KEY.
            client = Didit()

            for item in client.travel_rule.wallet_addresses.list():
                print(item)
        - lang: javascript
          label: Node.js
          source: |-
            import Didit from "@didit-protocol/sdk-node";

            // Reads DIDIT_API_KEY.
            const didit = new Didit();

            for await (const item of didit.travelRule.walletAddresses.list()) {
              console.log(item);
            }
        - lang: go
          label: Go
          source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\niter := client.TravelRule.WalletAddresses.ListAutoPaging(ctx, didit.TravelRuleWalletAddressesListParams{})\nfor iter.Next() {\n\tfmt.Printf(\"%+v\\n\", iter.Current())\n}\nif err := iter.Err(); err != nil {\n\tlog.Fatal(err)\n}"
        - lang: java
          label: Java
          source: |-
            import me.didit.Didit;

            // Reads DIDIT_API_KEY.
            Didit client = new Didit();

            for (var item : client.travelRule().walletAddresses().list()) {
                System.out.println(item);
            }
        - lang: php
          label: PHP
          source: |-
            <?php

            require 'vendor/autoload.php';

            use Didit\DiditClient;

            // Reads DIDIT_API_KEY.
            $didit = new DiditClient();

            foreach ($didit->travelRule->walletAddresses->list() as $item) {
                print_r($item->toArray());
            }
        - lang: ruby
          label: Ruby
          source: |-
            require "didit"

            # Reads DIDIT_API_KEY.
            didit = Didit::Client.new

            didit.travel_rule.wallet_addresses.list.auto_paging_each do |item|
              puts item.to_h
            end
        - lang: csharp
          label: .NET
          source: >-
            using System;

            using System.Text.Json;

            using Didit;


            // Reads DIDIT_API_KEY.

            using var client = new DiditClient();


            await foreach (var item in await
            client.TravelRule.WalletAddresses.ListAsync())

            {
                Console.WriteLine(JsonSerializer.Serialize(item));
            }
components:
  schemas:
    WalletAddressEntry:
      type: object
      properties:
        uuid:
          type: string
          format: uuid
        address:
          type: string
          description: >-
            지갑 주소입니다. 해시로만 가져온 항목의 경우 `""`입니다. 대소문자를 구분하지 않고 주소를 비교하며, 애플리케이션,
            체인, 메모별로 고유합니다. 항목을 삭제한 후 동일한 주소를 다시 등록할 수 있습니다.
        chain:
          type: string
          description: >-
            주소에 대한 체인 token(예: `ETH` 또는 `BTC`). Didit이 이체를 라우팅하거나 등록할 때 지갑 주소를
            기준으로 주소록 항목을 매칭하며, 이체에 체인이 포함된 경우 대소문자를 무시하고 이 값도 기준으로 매칭합니다. 이체의
            체인은 `beneficiary_data.chain`이며, 직접 전송하지 않은 경우 거래의 암호화폐 체인 또는 통화
            기호(예: `ETH`)에서 채워지거나 입금 후 등록의 `chain`에서 채워지므로 모든 곳에서 동일한 token을
            사용하십시오. 체인이 비어 있는 항목은 모든 체인과 일치합니다. 비트코인에 등록된 Lightning 수취인(노드 id 또는
            Lightning Address)은 `LIGHTNING`에 소문자로 저장되며, 여기서 Lightning 이체가 매칭됩니다.
            알려진 체인은 어떤 철자로 전송하든 하나의 표준 식별자로 저장됩니다. "ethereum", "Ethereum",
            "ERC20"은 모두 ETH로 저장되고, "BNB Smart Chain" 및 "BEP20"은 BNB로, "tron"은
            TRX로 저장됩니다. 알 수 없는 체인 이름은 입력된 그대로 유지됩니다.
        holder_vendor_data:
          type: string
          description: 보유자에 대한 귀하의 내부 식별자입니다.
        holder_name:
          type: string
          description: 수취인 이름 대조에 사용되는 지갑 보유자 이름입니다.
        entity_type:
          type: string
          description: 자유 형식 텍스트이며 기본값은 "individual"입니다.
        is_ownership_verified:
          type: boolean
          description: 읽기 전용입니다. 이 주소의 소유권이 증명되었는지 여부입니다.
        created_at:
          type: string
          format: date-time
        travel_address:
          type: string
          description: >-
            알려진 경우, 이 지갑에 대한 거래 상대방 VASP의 Travel Address입니다. Didit이 TRP가 지원하는
            자산(BTC, ETH 및 지정된 네트워크의 USDC)에 대해 TRP 레일을 통해 이 수취인의 이체를 라우팅할 수 있도록
            합니다.
        address_hash:
          type: string
          description: >-
            읽기 전용입니다. 소문자로 변환된 주소의 SHA-256 해시값(소문자 16진수)입니다. 해시만으로 가져온 항목은 이 값을
            기준으로 매칭됩니다.
        memo:
          type: string
          description: >-
            메모 네트워크(XRP, XLM, EOS, ATOM, HBAR)의 지갑 일부인 대상 태그 또는 메모입니다. 주소 전체인 경우
            `""`입니다. 메모가 있는 항목은 해당 메모를 지정한 전송과만 일치하며, 메모가 없는 항목은 전체 주소와 일치합니다.
        receiving_travel_address:
          type: string
          readOnly: true
          description: >-
            이 지갑에 대한 지갑별 Travel Address입니다. 송금 VASP에 제공하여 해당 TRP 조회에서 이 지갑을 지정할
            수 있도록 합니다. 다른 VASP의 지갑으로 기록되어 있거나, Travel Rule이 비활성화되어 있는 동안, 그리고
            VASP 프로필이 저장되기 전에는 비어 있습니다.
  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.