travelrule_metadata object on PUT /v2/transfer/crypto-destination-address.
Fields
| Field | Type | Required (US) | Description |
|---|---|---|---|
custodian_type | enum | Always | Type of wallet at the destination: VASP (held at another regulated institution) or PRIVATE (unhosted/self-custody). Drives downstream validation. |
vasp.id | string | When custodian_type = VASP (preferred) | Paxos identifier for the receiving institution. Resolve via GET /v2/travelrule/vasps. |
vasp.custom_vasp_name | string | When custodian_type = VASP and no vasp.id available | Name of the receiving institution. Fallback for institutions not in the Paxos directory. |
vasp.custom_vasp_website | string | When vasp.custom_vasp_name is specified | Website URL of the receiving institution. Required alongside vasp.custom_vasp_name to identify off-directory VASPs. |
transfer_purpose | string | Optional (US); required in SG/EU | Purpose of the transfer. Recommended for partners with cross-jurisdictional flows. |
beneficiary | object | Always | Beneficiary details. Provide either person_details or institution_details, or set self = true for me-to-me transfers. |
beneficiary.self | boolean | Optional | Set true when the destination wallet belongs to the same end user as the originator. When set, omit person_details and institution_details. |
beneficiary.person_details.first_name | string | When beneficiary is a person | Legal first name. |
beneficiary.person_details.last_name | string | When beneficiary is a person | Legal last name. |
beneficiary.person_details.physical_address.country | string | When beneficiary is a person | ISO 3166-1 alpha-3 country code (e.g. USA). |
beneficiary.institution_details.name | string | When beneficiary is an institution | Legal name of the institution. |
beneficiary.institution_details.physical_address.country | string | When beneficiary is an institution | ISO 3166-1 alpha-3 country code (e.g. USA). |
beneficiary.person_details.physical_address.address1 | string | Optional | Street address line 1. |
beneficiary.person_details.physical_address.address2 | string | Optional | Street address line 2. |
beneficiary.person_details.physical_address.city | string | Optional | |
beneficiary.person_details.physical_address.province | string | Optional | State or province. |
beneficiary.person_details.physical_address.zip_code | string | Optional |
vasp.id or vasp.custom_vasp_name + vasp.custom_vasp_website, not both. Prefer vasp.id — Travel Rule messages can only be transmitted automatically when a directory ID is provided.
Examples
Each example below is aPUT /v2/transfer/crypto-destination-address request body.
Transfer to a person beneficiary at another VASP
{
"crypto_network": "ETHEREUM",
"address": "0xe4B0aCA9FB669817775274775b20e52118595515",
"nickname": "alice_coinbase",
"identity_id": "b8d9f2a1-3c4e-4f5a-9b6d-7e8f0a1b2c3d",
"travelrule_metadata": {
"custodian_type": "VASP",
"beneficiary": {
"person_details": {
"first_name": "Alice",
"last_name": "Smith",
"physical_address": {
"country": "USA"
}
}
},
"vasp": {
"id": "0b3d9f1e-7c2a-4e8b-9f1a-2c3d4e5f6a7b"
},
"transfer_purpose": "Investment"
}
}
Self-transfer to an unhosted wallet
{
"crypto_network": "ETHEREUM",
"address": "0xabc...",
"nickname": "alice_metamask",
"identity_id": "b8d9f2a1-3c4e-4f5a-9b6d-7e8f0a1b2c3d",
"travelrule_metadata": {
"custodian_type": "PRIVATE",
"beneficiary": {
"self": true
}
}
}
Transfer to a VASP not in the Paxos directory
{
"crypto_network": "ETHEREUM",
"address": "0xdef...",
"travelrule_metadata": {
"custodian_type": "VASP",
"beneficiary": {
"person_details": {
"first_name": "Bob",
"last_name": "Jones",
"physical_address": {
"country": "DEU"
}
}
},
"vasp": {
"custom_vasp_name": "Some Regional Exchange GmbH",
"custom_vasp_website": "https://some-regional-exchange.de"
},
"transfer_purpose": "Goods and services"
}
}
Transfer to an institution beneficiary
{
"crypto_network": "ETHEREUM",
"address": "0xghi...",
"travelrule_metadata": {
"custodian_type": "VASP",
"beneficiary": {
"institution_details": {
"name": "Acme Corp",
"physical_address": {
"country": "USA"
}
}
},
"vasp": {
"id": "1c4e0a2f-8d3b-4f9c-8a2b-3d4e5f6a7b8c"
},
"transfer_purpose": "Investment"
}
}