sumsub-resolve-currency — Claude Code skill: Sumsub currency fields
This skill works out which currency values a Sumsub transaction needs and stops you from guessing a chain for a token that exists on several networks.
npx skills add sumsub/agent-skills --skill sumsub-resolve-currency -a claude-codeWhat sumsub-resolve-currency does
The skill covers the currency fields of a transaction: info.currencyCode, info.currencyType, info.cryptoParams.cryptoChain, plus the amountInDefaultCurrency and defaultCurrencyCode pair. The catalogue comes from GET /resources/kyt/currency?type=crypto|fiat. Fiat is a membership test against ISO 4217 codes. Crypto is the hard part: the same ticker appears on different networks, so an asset is identified by symbol, chain and contract together.
Two scripts do the work. scripts/get_currencies.sh fetches the catalogue, and scripts/resolve_currency.py trims and uppercases the query, expands chain aliases such as TRC20 or BEP20, and returns exactly one asset. When several rows match, the script stops and hands you the candidate list — the choice stays yours. An empty chain is a value too: it means the native coin of its own network.
You need SUMSUB_APP_TOKEN and SUMSUB_SECRET_KEY. The script rejects tokens without the sbx: prefix unless SUMSUB_ALLOW_PROD=1 is set, so a sandbox key pair is not optional. amountInDefaultCurrency looks skippable, yet Travel Rule threshold comparison depends on it: leave it out and the check is skipped altogether. The value is frozen when the transaction is created, so a wrong rate stays on the record until you backfill it.
What it helps with
- find out which currency codes and chains Sumsub supports
- check whether USDT on TRON is supported
- fill in
cryptoChainfor a token that lives on several networks - debug a currency that is not recognised on submission
- trace where
amountInDefaultCurrencycomes from
Example prompts for the agent
- Which currency code and chain should I send for USDT on TRON?
- Check the Sumsub catalogue for this token
- My currency is not recognised — compare the symbol and chain
How to install sumsub-resolve-currency
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-resolve-currency -a claude-code2Manually: put the files in place
~/.claude/skills/sumsub-resolve-currency/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/sumsub-resolve-currency/
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-resolve-currency -a codex2Manually: put the files in place
.agents/skills/sumsub-resolve-currency/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-resolve-currency -a cursor2Manually: put the files in place
.cursor/skills/sumsub-resolve-currency/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install sumsub/agent-skills sumsub-resolve-currency2Manually: put the files in place
.github/skills/sumsub-resolve-currency/SKILL.md1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-resolve-currency -a gemini-cli2Platform CLI
gemini skills install https://github.com/sumsub/agent-skills --path skills/sumsub-resolve-currencyManually: put the files in place
.devin/skills/sumsub-resolve-currency/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-resolve-currency -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about sumsub-resolve-currency
How do I install sumsub-resolve-currency in Claude Code?
Run npx skills add sumsub/agent-skills --skill sumsub-resolve-currency -a claude-code. The skill lands in ~/.claude/skills/sumsub-resolve-currency/SKILL.md.
What does sumsub-resolve-currency do?
It resolves the currency fields of a Sumsub transaction and maps a symbol and chain pair to a single catalogue asset. On ambiguity it returns the candidates instead of guessing.
What does the skill need to run?
A SUMSUB_APP_TOKEN and SUMSUB_SECRET_KEY pair. Only sandbox tokens with the sbx: prefix are accepted unless SUMSUB_ALLOW_PROD=1 is set.
