Create a holding

POST

https://api.t-dx.com/api/rest/v1/holdings

POST

/api/rest/v1/holdings

curl -X POST https://api.t-dx.com/api/rest/v1/holdings \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "clientAccountId": "string",
  "promotionId": "string",
  "quantity": "100.0"
}'

{
  "result": {
    "id": "string",
    "investorId": "string",
    "issuerClientAccountId": "string",
    "instrumentId": "string",
    "balanceId": "string",
    "quantity": "string",
    "sourceType": "HOLDING_SOURCE_TYPE_ISSUER",
    "warranted": true,
    "includeInBalance": true,
    "createdAt": "2024-01-15T09:30:00Z",
    "updatedAt": "2024-01-15T09:30:00Z",
    "deletedAt": "2024-01-15T09:30:00Z",
    "promotionId": "string",
    "instrument": {
      "id": "string",
      "blockchain": "string",
      "decimals": 1,
      "contractAddress": "string",
      "fullName": "string",
      "symbol": "string"
    },
    "externalAddress": {
      "id": "string",
      "address": "string"
    },
    "promotion": {
      "id": "string",
      "tokensLockedUntil": "2024-01-15T09:30:00Z",
      "subscriptionPrice": "string"
    },
    "investor": {
      "id": "string",
      "clientAccountId": "string"
    },
    "tokenClaim": {
      "id": "string",
      "investorExternalAddressId": "string",
      "transactionHash": "string",
      "createdAt": "2024-01-15T09:30:00Z",
      "status": "TOKEN_CLAIM_STATUS_CREATED"
    },
    "registeredAt": "2024-01-15T09:30:00Z",
    "investorExternalAddressID": "string",
    "holderId": "string"
  }
}

This endpoint creates a holding

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

clientAccountIdstringRequiredformat: "uuid"

The uuid of the client account of the future holder

promotionIdstringRequiredformat: "uuid"

The uuid of the issuance

quantitystringRequiredformat: "decimal"

Quantity of tokens given to the holder

Response

A successful response.

resultobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

503

Service Unavailable Error