# sumsub-manage-wallet-address-book

Registers an organisation’s crypto wallets in Sumsub so Travel Rule requests can use stored ownership data. It covers bulk imports and applicant-linked payment methods.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 465 installs · ★ 7
- Author: sumsub
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/sumsub/agent-skills/tree/HEAD/skills/sumsub-manage-wallet-address-book/SKILL.md
- Updated: 2026-10-02
- HTML: https://affpapa.org/en/nevibecode/skills/sumsub-manage-wallet-address-book

## What it does

This skill sends organisation-controlled addresses to Sumsub’s Wallet Address Book with `POST /resources/kyt/walletAddress/import`. For a known applicant, it uses `POST /resources/api/applicants/{applicantId}/payments` to add one address as a `cryptoWallet` payment method. The second route links the wallet to a person.

It includes a JSON payload builder plus shell helpers for the import and payment-method requests. A bulk request can contain up to 10 000 entries and may return both accepted and rejected records, so `errorCount` and the reported errors need to be inspected. The flow uses sandbox `SUMSUB_APP_TOKEN` and `SUMSUB_SECRET_KEY`; bulk import also requires the token subject to have the `admin` role.

If the organisation is not linked to a VASP, the import returns HTTP 404 and retrying will not fix it. The tenant also needs the `TRAVEL_RULE` entitlement, and production App Tokens are rejected by the helper unless an override is set.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-manage-wallet-address-book -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/sumsub-manage-wallet-address-book/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/sumsub-manage-wallet-address-book/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-manage-wallet-address-book -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/sumsub-manage-wallet-address-book/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-manage-wallet-address-book -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/sumsub-manage-wallet-address-book/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install sumsub/agent-skills sumsub-manage-wallet-address-book
```

2. **Manually: put the files in place**
- File: `.github/skills/sumsub-manage-wallet-address-book/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-manage-wallet-address-book -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/sumsub/agent-skills --path skills/sumsub-manage-wallet-address-book
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/sumsub-manage-wallet-address-book/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-manage-wallet-address-book -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/sumsub/agent-skills/tree/HEAD/skills/sumsub-manage-wallet-address-book/SKILL.md

## When to use it
- bulk-import organisation-controlled wallet addresses
- link one crypto wallet to an applicant
- build a valid Wallet Address Book payload
- inspect rejected entries after a partial import
- reduce manual handling of Travel Rule requests

## Example prompts
- Import our organisation’s wallet addresses into Sumsub’s Wallet Address Book and report rejected entries.
- Register the applicant’s crypto wallet as a payment method for `<applicantId>`.
- Check the `TRAVEL_RULE` entitlement, build the payload from `wallets.yaml`, and submit the addresses.

## Similar
- [okx-agentic-wallet](https://affpapa.org/en/nevibecode/skills/okx-agentic-wallet.md) — skill · 17500 installs
- [emblem-ai-agent-wallet](https://affpapa.org/en/nevibecode/skills/emblem-ai-agent-wallet.md) — skill · 8800 installs
- [binance-agentic-wallet](https://affpapa.org/en/nevibecode/skills/binance-agentic-wallet.md) — skill · 18400 installs
- [gmgn-wallet-review](https://affpapa.org/en/nevibecode/skills/gmgn-wallet-review.md) — skill · 2400 installs
- [gmgn-wallet-score](https://affpapa.org/en/nevibecode/skills/gmgn-wallet-score.md) — skill · 2400 installs
- [nansen-wallet-profiler](https://affpapa.org/en/nevibecode/skills/nansen-wallet-profiler.md) — skill · 407 installs

From the same set: [sumsub/agent-skills](https://affpapa.org/en/nevibecode/by/sumsub/agent-skills.md) — 25 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md