OKX Travel Rule

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.

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.

Example

{
  "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.

Get Started

Transactions

API Co-Signers

Workspace & Security

Webhooks

Direct Custody Wallets

Manage Wallets

Embedded Wallets

Canton

Gas Management

Treasury & Trading

Smart Contracts & Tokenization

Assets & NFTs

Identity & Compliance

Compliance Screening

Compliance Tooling

Payments

Offchain Signing

Key Link

Integrations

Required fields for withdrawals

Identify the counterparty VASP

Example

On the Help Center

​Required fields for withdrawals

​Identify the counterparty VASP

​Example

​On the Help Center

Required fields for withdrawals

Identify the counterparty VASP

Example

On the Help Center