Search VASPs

Search for Virtual Asset Service Providers by name or other criteria with automatic variable setting.

Endpoint

GET https://api.trpcontinuum.com/trp/vasps/search

Headers

Header	Value	Required
x-api-key	{your-api-key}	Yes
x-secret-key	{your-secret-key}	Yes

Query Parameters

Parameter	Type	Required	Description
q	string	Yes	Search query (VASP name, legal name, or website)
limit	integer	No	Max results (default: 20, max: 100)
offset	integer	No	Pagination offset (default: 0)
status	string	No	Filter by status
country	string	No	Filter by country
network	string	No	Filter by supported network

Response

Success (200 OK)

{
  "success": true,
  "data": [
    {
      "id": "c8f61f62-1a20-41e9-9ac3-0ffb59bcf00e",
      "name": "SecureWallet Inc",
      "website": "https://securewallet.com"
    }
  ]
}

No Results (200 OK)

{
  "success": true,
  "data": [],
  "pagination": {
    "total": 0,
    "limit": 20,
    "offset": 0,
    "hasMore": false,
    "query": "nonexistent"
  },
  "message": "No VASPs found matching the search criteria"
}

Error (400 Bad Request)

{
  "success": false,
  "error": "Search query is required",
  "code": "MISSING_QUERY"
}

Search Features

Auto-Variable Setting

The search automatically sets the vaspId variable to the first result's ID for use in subsequent Postman requests.

Match Scoring

• 0.9-1.0: Exact or near-exact matches
• 0.7-0.89: Strong partial matches
• 0.5-0.69: Weak matches
• Below 0.5: Results not returned

Search Fields

Searches across:

• VASP display name
• Legal entity name
• Website domain
• Alternative names/aliases

Search Behavior

Query Processing

• Case-insensitive search
• Partial word matching
• Fuzzy matching for typos
• Domain extraction from URLs

Ranking Algorithm

Results ranked by:

1. Exact name matches
2. Partial name matches
3. Legal name matches
4. Website domain matches
5. Historical search popularity

Example Requests

Basic search

curl -X GET "{{baseUrl}}/trp/vasps/search?q=test" \
  -H "x-api-key: {your-api-key}" \
  -H "x-secret-key: {your-secret-key}"

Search with filters

curl -X GET "{{baseUrl}}/trp/vasps/search?q=exchange&country=US&status=verified" \
  -H "x-api-key: {your-api-key}" \
  -H "x-secret-key: {your-secret-key}"

Search by network support

curl -X GET "{{baseUrl}}/trp/vasps/search?q=crypto&network=ethereum" \
  -H "x-api-key: {your-api-key}" \
  -H "x-secret-key: {your-secret-key}"

Paginated search

curl -X GET "{{baseUrl}}/trp/vasps/search?q=bank&limit=10&offset=20" \
  -H "x-api-key: {your-api-key}" \
  -H "x-secret-key: {your-secret-key}"

Advanced Search Tips

Wildcard Searches

• Use * for any characters: crypto* matches "CryptoBank", "CryptoExchange"
• Use ? for single character: ban? matches "bank", "band"

Phrase Searches

• Use quotes for exact phrases: "digital assets"
• Searches within legal names and descriptions

Domain Searches

• Search by domain: example.com finds VASPs with that website
• Subdomain matching: api.example.com matches example.com

Use Cases

1. VASP Discovery: Find trading partners
2. Compliance Verification: Check VASP status before transactions
3. Network Compatibility: Find VASPs supporting specific blockchains
4. Regional Filtering: Comply with jurisdiction restrictions
5. Integration: Populate dropdown lists in applications

Performance

• Average response time: < 50ms
• Index refreshed every 5 minutes
• Full-text search across all fields