> ## Documentation Index
> Fetch the complete documentation index at: https://developers.fireblocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OKX Travel Rule

> The Travel Rule `piiData` fields OKX requires for withdrawals to hosted and private wallets, with an example.

OKX requires Travel Rule `piiData` for withdrawals. What you send depends on whether the destination is a hosted wallet, at a VASP or exchange, or a private wallet. For how to build, encrypt, and send the payload, see [Exchanges](/docs/exchanges-travel-rule).

## Required fields for withdrawals

| Path | Values | Required when |
| - | - | - |
| `data.beneficiary.isHosted` | `"true"` for exchange-hosted accounts; `"false"` for private accounts | Always |
| `data.beneficiary.entityType` | `Individual`, `Business` | Always |
| `data.beneficiary.names[0].primaryName` | Free text, with `nameType` `Latin` | Hosted wallet, `Individual` |
| `data.beneficiary.names[0].secondaryName` | Free text | Hosted wallet, `Individual` |
| `data.beneficiary.company.name` | Free text | Hosted wallet, `Business` |
| `data.beneficiary.postalAddress.streetName` | Free text | Hosted wallet |
| `data.beneficiary.postalAddress.buildingNumber` | Free text | Hosted wallet |
| `data.beneficiary.postalAddress.city` | Free text | Hosted wallet |
| `data.beneficiary.postalAddress.postalCode` | Free text | Hosted wallet |
| `data.beneficiary.postalAddress.subdivision` | Free text | Hosted wallet |
| `data.beneficiary.postalAddress.country` | Free text | Hosted wallet |
| `data.beneficiaryVASP.vaspCode` | Value from the OKX VASP list | Hosted wallet |
| `data.beneficiaryVASP.vaspName` | Free text | Hosted wallet and the VASP is not in the OKX VASP list |

## Identify the counterparty VASP

For `beneficiaryVASP`, use the VASP's DID as `vaspCode`. For a VASP without a DID, set `vaspCode` to `"-2"` and `vaspName` to the VASP's name. OKX publishes the full list of VASPs it supports through its [exchange list endpoint](https://www.okx.com/docs-v5/en/#funding-account-rest-api-get-exchange-list-public).

## Example

```json theme={"system"}
{
  "type": "exchange-service-travel-rule",
  "typeVersion": "1.0.0",
  "data": {
    "beneficiary": {
      "isHosted": "true",
      "entityType": "Individual",
      "names": [{ "primaryName": "John", "secondaryName": "Doe", "nameType": "Latin" }],
      "postalAddress": {
        "streetName": "Oak",
        "buildingNumber": "1",
        "city": "Boston",
        "postalCode": "11000",
        "subdivision": "Massachusetts",
        "country": "US"
      }
    },
    "beneficiaryVASP": { "vaspCode": "-2", "vaspName": "ACME VASP" }
  }
}
```

## On the Help Center

To provide OKX Travel Rule data in the Console, see [OKX travel rule](https://support.fireblocks.io/hc/en-us/articles/30750129326364-OKX-travel-rule).
