Issue Tokens

Mint new stock tokens to a recipient address

POST /stocks/api/tokenization/{tokenAddress}/issue

cURL

curl -X POST "https://api.trusset.org/stocks/api/tokenization/0x1234.../issue" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: trusset_abc123xy_secret..." \
  -d '{
    "recipient": "0xAbC123dEf456789012345678901234567890AbCd",
    "amount": "1000",
    "reason": "Initial allocation",
    "useRelayer": true
  }'

Response

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

Issues (mints) new tokens from a deployed stock token contract to a specified recipient. The caller must have issuer or sub-issuer privileges on the token contract.

Path Parameters

tokenAddress · string · required

Address of the stock token contract.

Request Body

recipient · string · required

Ethereum address receiving the newly minted tokens.

amount · string · required

Number of tokens to issue, as a human-readable string (e.g., "1000.5"). Must be greater than zero.

reason · string

Optional reason or reference for the issuance, stored in the event log.

useRelayer · boolean · default: "false"

When true, the transaction is signed and submitted by the Trusset relayer.

Response Fields

success · boolean

Request status.

data · object

Issuance result including the transaction hash.

cURL

curl -X POST "https://api.trusset.org/stocks/api/tokenization/0x1234.../issue" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: trusset_abc123xy_secret..." \
  -d '{
    "recipient": "0xAbC123dEf456789012345678901234567890AbCd",
    "amount": "1000",
    "reason": "Initial allocation",
    "useRelayer": true
  }'

Response

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