Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

VASPs

The VASP directory used to identify counterparty institutions.

List VASPs

get

Retrieve a paginated and sortable list of VASP (Virtual Asset Service Provider) records from the directory.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
pageinteger · min: 1OptionalDefault: 1
sizeinteger · min: 1 · max: 100OptionalDefault: 30
sortstring · nullableOptional
start_rangestring · date · nullableOptional
end_rangestring · date · nullableOptional
Responses
200

A page of VASP records from the directory.

application/json
anyOptional
get/api/v2/directory/vasps
GET /api/v2/directory/vasps HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "success",
  "data": {
    "items": [
      {
        "vasp_id": "MLESJF",
        "name_legal": "Meridian Exchange Ltd",
        "name_business": "Meridian",
        "address_country_code": "SG",
        "address_street_no": "1",
        "address_street_name": "Raffles Place",
        "address_city": "Singapore",
        "address_region": "Central",
        "address_postcode": "048616",
        "website": "https://meridian.example",
        "summary": "Regulated virtual asset exchange",
        "supported_protocols": [
          "trisa",
          "trp"
        ],
        "national_id_type_code": "LEIX",
        "national_id": "5493001KJTIIGC8Y1R12"
      }
    ],
    "pagination": {
      "total": 1,
      "size": 50,
      "page": 1
    }
  }
}

Search VASP

get

Search for VASP (Virtual Asset Service Provider) records using identifiers such as business or legal names. Returns an empty result set when no matching records are found.

To find the VASP behind a destination wallet, send wallet_address with the dti of the asset instead of search_term. The result lists the VASPs you can send to that claim the wallet, in the same shape as a name search, including supported_protocols; it is empty when no such VASP is known.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
search_termstring · nullableOptional
wallet_addressstring · min: 1 · nullableOptional

Find the VASPs you can send to that claim this wallet address. Requires dti; not combinable with search_term. Returns an empty list when no VASP claims the wallet.

dtistring · min: 1 · nullableOptional

The Digital Token Identifier (ISO 24165) of the asset the wallet holds, e.g. X9J9K872S for Ether. Required with wallet_address; an unknown DTI is rejected with 422.

Responses
200

Matching VASPs. Unlike the account search, this one DOES use the {status, data} envelope.

application/json
anyOptional
get/api/v2/directory/vasps/search
GET /api/v2/directory/vasps/search HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "success",
  "data": [
    {
      "vasp_id": "MLESJF",
      "name_legal": "Meridian Exchange Ltd",
      "name_business": "Meridian",
      "address_country_code": "SG",
      "address_street_no": "1",
      "address_street_name": "Raffles Place",
      "address_city": "Singapore",
      "address_region": "Central",
      "address_postcode": "048616",
      "website": "https://meridian.example",
      "summary": "Regulated virtual asset exchange",
      "supported_protocols": [
        "trisa",
        "trp"
      ],
      "national_id_type_code": "LEIX",
      "national_id": "5493001KJTIIGC8Y1R12"
    }
  ]
}

Retrieve VASP

get

Retrieve a specific VASP (Virtual Asset Service Provider) record from the directory using its unique identifier.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
vasp_idstringRequired

The unique identifier of the VASP (Virtual Asset Service Provider).

Responses
200

The VASP record.

application/json
anyOptional
get/api/v2/directory/vasps/{vasp_id}
GET /api/v2/directory/vasps/{vasp_id} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "success",
  "data": {
    "vasp_id": "MLESJF",
    "name_legal": "Meridian Exchange Ltd",
    "name_business": "Meridian",
    "address_country_code": "SG",
    "address_street_no": "1",
    "address_street_name": "Raffles Place",
    "address_city": "Singapore",
    "address_region": "Central",
    "address_postcode": "048616",
    "website": "https://meridian.example",
    "summary": "Regulated virtual asset exchange",
    "supported_protocols": [
      "trisa",
      "trp"
    ],
    "national_id_type_code": "LEIX",
    "national_id": "5493001KJTIIGC8Y1R12"
  }
}

Last updated