Crypto Wallet Check

curl --request POST \
  --url https://api.example.com/kyc/crypto

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/kyc/crypto",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/kyc/crypto"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/kyc/crypto")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

POST

kyc

crypto

Crypto Wallet Check

curl --request POST \
  --url https://api.example.com/kyc/crypto

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/kyc/crypto",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/kyc/crypto"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/kyc/crypto")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

Check cryptocurrency wallet addresses against sanctions lists and risk databases. This endpoint validates wallet addresses and checks them against OFAC and other sanctions lists.

Endpoint

POST /kyc/crypto

Authentication

Requires kyc:create permission. Include your Bearer token in the Authorization header.

Description

The crypto wallet check endpoint validates cryptocurrency wallet addresses and checks them against sanctions lists. It supports multiple blockchain networks and performs:

Address Validation: Validates wallet address format for the specified network
Sanctions Screening: Checks address against OFAC and other sanctions lists
Risk Assessment: Identifies potential risks associated with the wallet
Transaction History: Optional analysis of transaction patterns

Request Body Parameters

Zero Data Retention (ephemeral mode)

You can request ephemeral processing with either the X-Data-Retention: ephemeral header or "data_retention": "ephemeral" in the JSON body. Per-request ephemeral must be enabled for your account first: the endpoint identifier crypto.check (or the wildcard *) has to appear in your tenant’s data_processing_config.allowed_ephemeral_endpoints, otherwise the request is rejected with a 400. Tenants can also opt in account-wide by setting data_processing_config.mode to ephemeral — the tenant-level setting always wins over per-request flags and does not require the allowlist. Contact support to enable either option on your account. When ephemeral mode is active, the API returns the normal analysis response but does not store a validation record (nothing appears in the dashboard history) and does not emit the detailed audit event. The ephemeral flag also propagates to the internal sanctions lookups (target wallet and source wallets), which skip their own persistence. The platform retains only an aggregate billing metric (one counted crypto check, with no wallet address or outcome references); tenants with retain_billing_metrics: false suppress that too. An invalid data_retention value returns 400 before any quota is consumed.

The wallet analysis queries third-party blockchain APIs (e.g. TronGrid) to fetch transaction history; those providers process the wallet address under their own policies. Ephemeral mode guarantees zero retention in Legaltalent’s own stores.

Supported Networks

Network	Code	Description
Tron	`TRX`	Tron blockchain (TRX, USDT-TRC20)
Bitcoin	`BTC`	Bitcoin blockchain
Ethereum	`ETH`	Ethereum blockchain (ETH, ERC-20 tokens)

Request Example

curl -X POST https://stg.kyc.legaltalent.ai/kyc/crypto \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_address": "TXYZabcdefghijklmnopqrstuvwxyz123456",
    "network": "TRX"
  }'

Check Multiple Lists

curl -X POST https://stg.kyc.legaltalent.ai/kyc/crypto \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_address": "TXYZabcdefghijklmnopqrstuvwxyz123456",
    "network": "TRX",
    "lists": ["ofac", "un"]
  }'

Response Format

Success Response - No Match

{
  "status": "success",
  "wallet_address": "TXYZabcdefghijklmnopqrstuvwxyz123456",
  "network": "TRX",
  "is_match": false,
  "match_count": 0,
  "matches": [],
  "address_valid": true,
  "processing_time_ms": 1250,
  "timestamp": "2024-11-22T10:30:00Z"
}

Success Response - Match Found

{
  "status": "success",
  "wallet_address": "TXYZabcdefghijklmnopqrstuvwxyz123456",
  "network": "TRX",
  "is_match": true,
  "match_count": 1,
  "matches": [
    {
      "entity_id": "12345",
      "wallet_address": "TXYZabcdefghijklmnopqrstuvwxyz123456",
      "list_name": "ofac",
      "confidence_score": 1.0,
      "programs": ["SDGT"],
      "details": {
        "sanctioned_entity": "Example Entity",
        "sanction_date": "2020-01-15"
      }
    }
  ],
  "address_valid": true,
  "processing_time_ms": 1450,
  "timestamp": "2024-11-22T10:30:00Z"
}

Response Fields

Field	Type	Description
`status`	string	Always `"success"` when check completes
`wallet_address`	string	The wallet address that was checked
`network`	string	The blockchain network
`is_match`	boolean	`true` if any matches were found
`match_count`	integer	Number of matches found
`matches`	array	Array of match objects (empty if no matches)
`address_valid`	boolean	Whether the address format is valid for the network
`processing_time_ms`	integer	Total processing time in milliseconds
`timestamp`	string	ISO 8601 timestamp of the check

Match Object

Field	Type	Description
`entity_id`	string	Unique identifier of the sanctioned entity
`wallet_address`	string	The wallet address that matched
`list_name`	string	Name of the list where match was found
`confidence_score`	float	Confidence score (0.0-1.0)
`programs`	array	Array of sanction program codes
`details`	object	Additional details about the match

Error Responses

400 Bad Request - Invalid Address

{
  "error": "Invalid wallet address format",
  "message": "Address does not match expected format for network TRX"
}

400 Bad Request - Unsupported Network

{
  "error": "Unsupported network",
  "message": "Network 'INVALID' is not supported. Supported networks: TRX, BTC, ETH"
}

400 Bad Request - Missing Parameters

{
  "error": "Missing required parameters",
  "message": "wallet_address and network are required"
}

Status Codes

Code	Description
200	Success - Check completed
400	Bad Request - Invalid parameters
401	Unauthorized - Missing or invalid token
403	Forbidden - Insufficient permissions
500	Internal Server Error

Usage Examples

Python Example

import requests

token = "YOUR_TOKEN"

response = requests.post(
    "https://stg.kyc.legaltalent.ai/kyc/crypto",
    headers={
        "Authorization": f"Bearer {token}",
        "Content-Type": "application/json"
    },
    json={
        "wallet_address": "TXYZabcdefghijklmnopqrstuvwxyz123456",
        "network": "TRX",
        "lists": ["ofac"]
    }
)

if response.status_code == 200:
    data = response.json()
    print(f"Match Found: {data['is_match']}")
    print(f"Match Count: {data['match_count']}")
    
    if data['matches']:
        for match in data['matches']:
            print(f"Match in {match['list_name']}: {match['details']}")
else:
    print(f"Error: {response.json()}")

JavaScript Example

const token = "YOUR_TOKEN";

async function checkCryptoWallet(address, network) {
  const response = await fetch(
    "https://stg.kyc.legaltalent.ai/kyc/crypto",
    {
      method: "POST",
      headers: {
        "Authorization": `Bearer ${token}`,
        "Content-Type": "application/json"
      },
      body: JSON.stringify({
        wallet_address: address,
        network: network,
        lists: ["ofac"]
      })
    }
  );
  
  const data = await response.json();
  
  if (response.ok) {
    console.log(`Match Found: ${data.is_match}`);
    console.log(`Match Count: ${data.match_count}`);
    
    if (data.matches.length > 0) {
      data.matches.forEach(match => {
        console.log(`Match in ${match.list_name}:`, match.details);
      });
    }
    
    return data;
  } else {
    console.error("Error:", data.error);
    throw new Error(data.error);
  }
}

Best Practices

Validate address format: Ensure wallet addresses match the expected format for the network
Check multiple lists: Use the lists parameter to check against multiple sanctions lists
Handle matches: Implement proper handling for matches found in sanctions lists
Network selection: Use the correct network code for the blockchain you’re checking
Error handling: Implement proper error handling for invalid addresses or network errors

Performance

Typical Response Time: 1-2 seconds
Rate Limits: Subject to API rate limiting (1,000 requests per 5 minutes)
Supported Networks: TRX (fully supported), BTC and ETH (partial support)

Integration Tips

Address Validation: Validate address format client-side before submitting
Network Detection: Automatically detect network based on address format when possible
Batch Processing: For multiple addresses, make separate requests
Error Handling: Handle network-specific errors appropriately

Overview

Compliance Screening

AI Analysis

Batch Processing

KYC Workflows & Sessions

Webhooks

Tenant Management

Watchlists

Reporting & Analytics

Monitoring

Crypto Wallet Check

Endpoint

Authentication

Description

Request Body Parameters

Zero Data Retention (ephemeral mode)

Supported Networks

Request Example

Check Multiple Lists

Response Format

Success Response - No Match

Success Response - Match Found

Response Fields

Match Object

Error Responses

400 Bad Request - Invalid Address

400 Bad Request - Unsupported Network

400 Bad Request - Missing Parameters

Status Codes

Usage Examples

Python Example

JavaScript Example

Best Practices

Performance

Integration Tips

​Endpoint

​Authentication

​Description

​Request Body Parameters

​Zero Data Retention (ephemeral mode)

​Supported Networks

​Request Example

​Check Multiple Lists

​Response Format

​Success Response - No Match

​Success Response - Match Found

​Response Fields

​Match Object

​Error Responses

​400 Bad Request - Invalid Address

​400 Bad Request - Unsupported Network

​400 Bad Request - Missing Parameters

​Status Codes

​Usage Examples

​Python Example

​JavaScript Example

​Best Practices

​Performance

​Integration Tips

Endpoint

Authentication

Description

Request Body Parameters

Zero Data Retention (ephemeral mode)

Supported Networks

Request Example

Check Multiple Lists

Response Format

Success Response - No Match

Success Response - Match Found

Response Fields

Match Object

Error Responses

400 Bad Request - Invalid Address

400 Bad Request - Unsupported Network

400 Bad Request - Missing Parameters

Status Codes

Usage Examples

Python Example

JavaScript Example

Best Practices

Performance

Integration Tips