Skip to main content
POST
/
stocks
/
api
/
manage
/
{tokenAddress}
/
force-transfer
curl -X POST "https://api.trusset.org/stocks/api/manage/0x1234.../force-transfer" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: trusset_abc123xy_secret..." \
  -d '{
    "from": "0xAbC123dEf456789012345678901234567890AbCd",
    "to": "0x9876543210fedcba9876543210fedcba98765432",
    "amount": "100",
    "reason": "Court order #12345",
    "useRelayer": true
  }'

{
  "success": true,
  "data": {
    "transactionHash": "0xdef456...",
    "tokenAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "from": "0xAbC123dEf456789012345678901234567890AbCd",
    "to": "0x9876543210fedcba9876543210fedcba98765432",
    "amount": "100"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-06-15T12:00:00.000Z",
    "instanceId": "inst_abc123"
  }
}
Executes a forced transfer of tokens from one address to another, bypassing the standard transfer approval flow. This is a regulatory action typically used for court-ordered transfers, error corrections, or compliance enforcement. Requires the CONTROLLER role.

​
Path Parameters

​
tokenAddress
string
required
Address of the stock token contract.

​
Request Body

​
from
string
required
Ethereum address to transfer tokens from.
​
to
string
required
Ethereum address to transfer tokens to.
​
amount
string
required
Number of tokens to transfer. Must be greater than zero.
​
reason
string
Reason for the forced transfer, stored in the event log for audit purposes.
​
useRelayer
boolean
default:"false"
When true, the transaction is signed and submitted by the Trusset relayer.

​
Response Fields

​
success
boolean
Request status.
​
data
object
Transfer result including the transaction hash.
curl -X POST "https://api.trusset.org/stocks/api/manage/0x1234.../force-transfer" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: trusset_abc123xy_secret..." \
  -d '{
    "from": "0xAbC123dEf456789012345678901234567890AbCd",
    "to": "0x9876543210fedcba9876543210fedcba98765432",
    "amount": "100",
    "reason": "Court order #12345",
    "useRelayer": true
  }'

{
  "success": true,
  "data": {
    "transactionHash": "0xdef456...",
    "tokenAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "from": "0xAbC123dEf456789012345678901234567890AbCd",
    "to": "0x9876543210fedcba9876543210fedcba98765432",
    "amount": "100"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-06-15T12:00:00.000Z",
    "instanceId": "inst_abc123"
  }
}