Trusset Protocol - Infrastructure for Asset Tokenization

POST

customers

api

identity

can-transfer

curl -X POST "https://api.trusset.org/customers/api/identity/can-transfer" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: trusset_abc123xy_secret..." \
  -d '{
    "from": "0xAbC123dEf456789012345678901234567890AbCd",
    "to": "0x1234567890abcdef1234567890abcdef12345678",
    "amount": "1000.0",
    "fromBalance": "5000.0",
    "toBalance": "200.0"
  }'

const response = await fetch(
  'https://api.trusset.org/customers/api/identity/can-transfer',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': 'trusset_abc123xy_secret...'
    },
    body: JSON.stringify({
      from: '0xAbC123dEf456789012345678901234567890AbCd',
      to: '0x1234567890abcdef1234567890abcdef12345678',
      amount: '1000.0',
      fromBalance: '5000.0',
      toBalance: '200.0'
    })
  }
);
const { data } = await response.json();

if (!data.allowed) {
  console.error('Transfer blocked:', data.violations);
}

{
  "success": true,
  "data": {
    "allowed": true,
    "from": "0xAbC123dEf456789012345678901234567890AbCd",
    "to": "0x1234567890abcdef1234567890abcdef12345678"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-06-15T12:00:00.000Z"
  }
}

{
  "success": true,
  "data": {
    "allowed": false,
    "from": "0xAbC123dEf456789012345678901234567890AbCd",
    "to": "0x1234567890abcdef1234567890abcdef12345678",
    "violations": [
      "Receiver identity not verified",
      "Receiver country restricted"
    ]
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-06-15T12:00:00.000Z"
  }
}

Checks the on-chain compliance module to determine whether a transfer between two addresses would be allowed. The check evaluates both sender and receiver identity status, investor type restrictions, country rules, and balance limits configured in the instance’s compliance contracts. Use this as a pre-flight check before submitting transfer transactions to avoid on-chain reverts.

Request Body

string

required

Sender wallet address.

string

required

Receiver wallet address.

string

default:"0"

Transfer amount as a human-readable string (e.g., "1000.5").

string

default:"0"

Current balance of the sender. Used for balance-based compliance rules.

string

default:"0"

Current balance of the receiver. Used for balance-based compliance rules.

Response Fields

boolean

Request status

object

Compliance check result. Structure depends on the compliance module configuration. Typically includes an allowed boolean and, when the transfer is blocked, a reason or violations array describing which rules failed.

curl -X POST "https://api.trusset.org/customers/api/identity/can-transfer" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: trusset_abc123xy_secret..." \
  -d '{
    "from": "0xAbC123dEf456789012345678901234567890AbCd",
    "to": "0x1234567890abcdef1234567890abcdef12345678",
    "amount": "1000.0",
    "fromBalance": "5000.0",
    "toBalance": "200.0"
  }'

const response = await fetch(
  'https://api.trusset.org/customers/api/identity/can-transfer',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': 'trusset_abc123xy_secret...'
    },
    body: JSON.stringify({
      from: '0xAbC123dEf456789012345678901234567890AbCd',
      to: '0x1234567890abcdef1234567890abcdef12345678',
      amount: '1000.0',
      fromBalance: '5000.0',
      toBalance: '200.0'
    })
  }
);
const { data } = await response.json();

if (!data.allowed) {
  console.error('Transfer blocked:', data.violations);
}

{
  "success": true,
  "data": {
    "allowed": true,
    "from": "0xAbC123dEf456789012345678901234567890AbCd",
    "to": "0x1234567890abcdef1234567890abcdef12345678"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-06-15T12:00:00.000Z"
  }
}

{
  "success": true,
  "data": {
    "allowed": false,
    "from": "0xAbC123dEf456789012345678901234567890AbCd",
    "to": "0x1234567890abcdef1234567890abcdef12345678",
    "violations": [
      "Receiver identity not verified",
      "Receiver country restricted"
    ]
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-06-15T12:00:00.000Z"
  }
}

Identity Status

Create ID Link

curl -X POST "https://api.trusset.org/customers/api/identity/can-transfer" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: trusset_abc123xy_secret..." \
  -d '{
    "from": "0xAbC123dEf456789012345678901234567890AbCd",
    "to": "0x1234567890abcdef1234567890abcdef12345678",
    "amount": "1000.0",
    "fromBalance": "5000.0",
    "toBalance": "200.0"
  }'

const response = await fetch(
  'https://api.trusset.org/customers/api/identity/can-transfer',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': 'trusset_abc123xy_secret...'
    },
    body: JSON.stringify({
      from: '0xAbC123dEf456789012345678901234567890AbCd',
      to: '0x1234567890abcdef1234567890abcdef12345678',
      amount: '1000.0',
      fromBalance: '5000.0',
      toBalance: '200.0'
    })
  }
);
const { data } = await response.json();

if (!data.allowed) {
  console.error('Transfer blocked:', data.violations);
}

{
  "success": true,
  "data": {
    "allowed": true,
    "from": "0xAbC123dEf456789012345678901234567890AbCd",
    "to": "0x1234567890abcdef1234567890abcdef12345678"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-06-15T12:00:00.000Z"
  }
}

{
  "success": true,
  "data": {
    "allowed": false,
    "from": "0xAbC123dEf456789012345678901234567890AbCd",
    "to": "0x1234567890abcdef1234567890abcdef12345678",
    "violations": [
      "Receiver identity not verified",
      "Receiver country restricted"
    ]
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-06-15T12:00:00.000Z"
  }
}

Overview

MiCA Register

Customers

Stock Tokenization

Trading

Stock Lending

External Securities Lending

Check Transfer Compliance

Request Body

Response Fields

​Request Body

​Response Fields

Request Body

Response Fields