Investor

Token Sales

Retrieve a list of token sales

get

This endpoint provides a paginated list of token sales available on the platform. Users can filter sales by investment type, status, and sort order. This is essential for investors looking to explore and participate in ongoing or upcoming token sales.

Authorizations
Query parameters
pageintegerOptional

Page number for pagination

limitintegerOptional

Number of items per page

termstringOptional

Search term for asset title or description

investmentnumber · enumOptional

Investment type 0 - All // Default, can be omitted 1 - Equity 2 - Debt

Possible values:
statusnumber · enumOptional

Status of the token sale 0 - All // Default, can be omitted 1 - Active 2 - Upcoming 3 - Ended

Possible values:
sortstring · enumOptional

Sort order none - Default, can be omitted price|l-h - Sort by price low to high price|h-l - Sort by price high to low return|h-l - Sort by expected returns high to low

Possible values:
Responses
200
Token sales retrieved successfully
application/json
get
GET /api/v/1/token-sales HTTP/1.1
Host: localhost:5004
x-api-key: YOUR_API_KEY
Accept: */*
200

Token sales retrieved successfully

{
  "status": "SUCCESS",
  "response": {
    "sales": [
      {
        "id": "text",
        "tokenId": "text",
        "tokenName": "text",
        "tokenSymbol": "text",
        "name": "text",
        "description": "text",
        "startDate": "2025-07-06T16:57:40.016Z",
        "endDate": "2025-07-06T16:57:40.016Z",
        "payoutStartDate": "2025-07-06T16:57:40.016Z",
        "tokenCountOnSale": 1,
        "images": [
          {
            "name": "text",
            "size": 1,
            "type": "text",
            "url": "text"
          }
        ],
        "documents": [
          {
            "id": "text",
            "name": "text",
            "size": 1,
            "type": "text",
            "url": "text",
            "title": "text",
            "description": "text",
            "order": 1
          }
        ],
        "softCap": 1,
        "timezone": "text",
        "expectedReturns": 1,
        "totalSoldTokens": 1,
        "percentageTokenSold": 1,
        "createdAt": "2025-07-06T16:57:40.016Z",
        "updatedAt": "2025-07-06T16:57:40.016Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 1,
      "totalPages": 1,
      "totalItems": 1
    }
  }
}

Purchase tokens from a token sale

post

This endpoint facilitates the purchase of tokens from a specific token sale. It requires details such as the token sale ID, user wallet address, and purchase amount. Upon successful processing, the tokens are allocated to the user's account. This is essential for investors looking to acquire tokens from active sales.

Authorizations
Body
tokenSaleIdstringRequired

Identifier of the token sale

userAddressstringRequired

Wallet address of the user

amountnumber · floatRequired

Amount of tokens to purchase

currencyContractstringRequired

Currency contract address

timezonestringRequired

Timezone of the user

Responses
201
Tokens purchased successfully
application/json
post
POST /api/v/1/token-sales/buy HTTP/1.1
Host: localhost:5004
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 98

{
  "tokenSaleId": "text",
  "userAddress": "text",
  "amount": 1,
  "currencyContract": "text",
  "timezone": "text"
}
201

Tokens purchased successfully

{
  "status": "SUCCESS",
  "response": {
    "result": {
      "transactionId": "text",
      "tokenSaleId": "text",
      "amount": 1,
      "userAddress": "text",
      "status": "text"
    }
  }
}

Retrieve details of a specific token sale

get

This endpoint fetches detailed information about a specific token sale identified by its ID. It includes comprehensive details such as the sale's name, description, token count, and associated documents. This is crucial for investors and administrators who need in-depth information about a particular token sale.

Authorizations
Path parameters
tokenSaleIdstringRequired

Token sale ID

Responses
200
Token sale retrieved successfully
application/json
Responseall of
get
GET /api/v/1/token-sales/{tokenSaleId} HTTP/1.1
Host: localhost:5004
x-api-key: YOUR_API_KEY
Accept: */*
200

Token sale retrieved successfully

{
  "status": 0,
  "response": {
    "sale": {
      "id": "text",
      "tokenId": "text",
      "tokenName": "text",
      "tokenSymbol": "text",
      "name": "text",
      "description": "text",
      "startDate": "2025-07-06T16:57:40.016Z",
      "endDate": "2025-07-06T16:57:40.016Z",
      "payoutStartDate": "2025-07-06T16:57:40.016Z",
      "tokenCountOnSale": 1,
      "images": [
        {
          "name": "text",
          "size": 1,
          "type": "text",
          "url": "text"
        }
      ],
      "documents": [
        {
          "id": "text",
          "name": "text",
          "size": 1,
          "type": "text",
          "url": "text",
          "title": "text",
          "description": "text",
          "order": 1
        }
      ],
      "softCap": 1,
      "timezone": "text",
      "expectedReturns": 1,
      "totalSoldTokens": 1,
      "percentageTokenSold": 1,
      "createdAt": "2025-07-06T16:57:40.016Z",
      "updatedAt": "2025-07-06T16:57:40.016Z"
    }
  }
}

Investment Portfolio

Retrieve investments by user ID

get

This endpoint fetches a list of investments made by a specific user. It includes details about the tokens held, transaction history, and pagination options. This is crucial for users to track their investment portfolio and performance.

Authorizations
Query parameters
pageintegerOptional

Page number for pagination

limitintegerOptional

Number of items per page

Responses
200
Investments retrieved successfully
application/json
Responseall of
get
GET /api/v/1/investments/user/tokens HTTP/1.1
Host: localhost:5004
x-api-key: YOUR_API_KEY
Accept: */*
{
  "status": 0,
  "response": {
    "tokens": [
      {
        "id": "text",
        "tokenId": "text",
        "assetId": "text",
        "icon": "text",
        "name": "text",
        "symbol": "text",
        "assetName": "text",
        "assetCategoryText": "text",
        "investmentTypeText": "text",
        "propertyTypeText": "text",
        "title": "text",
        "currency": "text",
        "requiresTokenBuyBack": 1,
        "tokenPrice": 1,
        "totalInvestment": 1,
        "totalInvestmentWithCurrency": "text",
        "tokenCount": 1,
        "totalTokenCount": 1,
        "pendingTokenCount": 1,
        "burnTokenCount": 1,
        "tokenPercentage": 1,
        "badges": [
          {
            "title": "text",
            "value": "text"
          }
        ],
        "softCaps": [
          {
            "amountToBeInvested": 1,
            "cap": 1,
            "saleEndDate": "text",
            "saleId": "text",
            "status": 1,
            "saleName": "text",
            "subscriptionCount": 1,
            "subscriptionPercentage": 1,
            "supply": 1
          }
        ]
      }
    ],
    "metaData": {
      "totalInvestment": "text",
      "tokenHoldings": 1,
      "currency": "text"
    }
  },
  "pagination": {
    "page": 1,
    "limit": 1,
    "totalPages": 1,
    "totalItems": 1
  }
}

Retrieve transactions for a user by token ID

get

This endpoint provides a list of transactions for a specific user and token. It includes transaction types, status, and pagination options. This is useful for users to monitor their transaction history and investment activities.

Authorizations
Path parameters
tokenIdstringRequired
Query parameters
pageintegerOptional

Page number for pagination

limitintegerOptional

Number of items per page

Responses
200
Investments retrieved successfully
application/json
Responseall of
get
GET /api/v/1/investments/user/tokens/{tokenId}/transactions HTTP/1.1
Host: localhost:5004
x-api-key: YOUR_API_KEY
Accept: */*
{
  "status": 0,
  "response": {
    "transactions": [
      {
        "id": "text",
        "explorerUrl": "text",
        "type": "text",
        "principalExplorerUrl": "text",
        "txnDate": "text",
        "amount": 1,
        "principalAmount": 1,
        "burnAmount": 1,
        "interestAmount": 1,
        "delayedInterestAmount": 1,
        "pricePerToken": 1,
        "total": 1,
        "fromWallet": "text",
        "toWallet": "text",
        "fromWalletAddress": "text",
        "toWalletAddress": "text",
        "tokenSaleName": "text",
        "tokenSaleId": "text",
        "payoutId": "text",
        "payoutName": "text",
        "status": 1,
        "tokenId": "text",
        "tokenName": "text",
        "tokenSymbol": "text",
        "tokenIcon": "text",
        "assetId": "text",
        "assetName": "text",
        "payoutDocuments": [],
        "usdTotalValue": "text",
        "totalValue": "text",
        "tokenCount": 1,
        "soldTokens": 1,
        "usdTokenValue": 1,
        "tokenValue": 1,
        "currency": "text",
        "tokenAddress": "text",
        "tokenAddressUrl": "text"
      }
    ]
  },
  "pagination": {
    "page": 1,
    "limit": 1,
    "totalPages": 1,
    "totalItems": 1
  }
}

Retrieve all transactions for a user

get

This endpoint returns a comprehensive list of all transactions made by a user. It includes transaction details such as types, status, and pagination options. This is essential for users to have a complete view of their financial activities on the platform.

Authorizations
Query parameters
pageintegerOptional

Page number for pagination

limitintegerOptional

Number of items per page

Responses
200
Transactions retrieved successfully
application/json
Responseall of
get
GET /api/v/1/investments/user/transactions HTTP/1.1
Host: localhost:5004
x-api-key: YOUR_API_KEY
Accept: */*
{
  "status": 0,
  "response": {
    "transactions": [
      {
        "id": "text",
        "explorerUrl": "text",
        "type": "text",
        "principalExplorerUrl": "text",
        "txnDate": "text",
        "amount": 1,
        "principalAmount": 1,
        "burnAmount": 1,
        "interestAmount": 1,
        "delayedInterestAmount": 1,
        "pricePerToken": 1,
        "total": 1,
        "fromWallet": "text",
        "toWallet": "text",
        "fromWalletAddress": "text",
        "toWalletAddress": "text",
        "tokenSaleName": "text",
        "tokenSaleId": "text",
        "payoutId": "text",
        "payoutName": "text",
        "status": 1,
        "tokenId": "text",
        "tokenName": "text",
        "tokenSymbol": "text",
        "tokenIcon": "text",
        "assetId": "text",
        "assetName": "text",
        "payoutDocuments": [],
        "usdTotalValue": "text",
        "totalValue": "text",
        "tokenCount": 1,
        "soldTokens": 1,
        "usdTokenValue": 1,
        "tokenValue": 1,
        "currency": "text",
        "tokenAddress": "text",
        "tokenAddressUrl": "text"
      }
    ]
  },
  "pagination": {
    "page": 1,
    "limit": 1,
    "totalPages": 1,
    "totalItems": 1
  }
}

Payouts

Retrieve payout schedule for a debt token sale

get

This endpoint returns the payout schedule for a specific debt token sale. It includes details such as principal, interest, and total amounts. This is essential for investors to plan and anticipate payout activities related to a token sale.

Authorizations
Path parameters
storeIdstringRequired

Identifier of the store

tokenIdstringRequired

Identifier of the token

tokenSaleIdstringRequired

Identifier of the token sale

Query parameters
quantitynumberOptional

Quantity of the token sale

datestringOptional

Date of purchase

timezonestringOptional

Timezone of the user

Responses
200
Schedule retrieved successfully
application/json
Responseall of
get
GET /api/v/1/payouts/{storeId}/token/{tokenId}/sale/{tokenSaleId}/schedule HTTP/1.1
Host: localhost:5004
x-api-key: YOUR_API_KEY
Accept: */*
{
  "status": 0,
  "response": {
    "schedules": [
      {
        "totalAmount": 1,
        "principal": 1,
        "interestAmount": 1,
        "principalPercentage": 1,
        "interestPercentage": 1,
        "pointsDifference": 1,
        "interestIncurred": 1,
        "burnAmount": 1,
        "payoutName": "text",
        "payoutDate": "text",
        "frequencyType": "text",
        "index": 1
      }
    ],
    "totalPrincipal": 1,
    "totalInterest": 1,
    "totalAmount": 1
  }
}

Retrieve payout schedule for a token

get

This endpoint provides the payout schedule for a specific token, including principal and interest amounts. It is useful for investors to understand the timing and amounts of future payouts.

Authorizations
Path parameters
storeIdstringRequired

Identifier of the store

tokenIdstringRequired

Identifier of the token

Query parameters
quantitynumberOptional

Quantity of the token

datestringOptional

Date of purchase

timezonestringOptional

Timezone of the user

Responses
200
Schedule retrieved successfully
application/json
Responseall of
get
GET /api/v/1/payouts/{storeId}/token/{tokenId}/schedule HTTP/1.1
Host: localhost:5004
x-api-key: YOUR_API_KEY
Accept: */*
{
  "status": 0,
  "response": {
    "schedules": [
      {
        "totalAmount": 1,
        "principal": 1,
        "interestAmount": 1,
        "principalPercentage": 1,
        "interestPercentage": 1,
        "pointsDifference": 1,
        "interestIncurred": 1,
        "burnAmount": 1,
        "payoutName": "text",
        "payoutDate": "text",
        "frequencyType": "text",
        "index": 1
      }
    ],
    "totalPrincipal": 1,
    "totalInterest": 1,
    "totalAmount": 1
  }
}

KYC

Update user identity for token store

post

This endpoint updates the KYC (Know Your Customer) information for a user in the token store. It requires details such as country code and other identity attributes. This is crucial for ensuring compliance with regulatory requirements and verifying user identities.

Authorizations
Body
countryCodenumberRequired

ISO 3166-1 numeric code

Responses
200
Token identity updated successfully
application/json
Responseall of
post
POST /api/v/1/identity/kyc HTTP/1.1
Host: localhost:5004
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 17

{
  "countryCode": 1
}
200

Token identity updated successfully

{
  "status": 0,
  "response": {
    "kycStatus": "text",
    "kycDetails": {},
    "orgId": "text",
    "updatedAt": "text",
    "createdAt": "text",
    "id": "text",
    "countryId": "text",
    "countryName": "text",
    "userId": "text",
    "accredit": {}
  }
}

Retrieve contract addresses for token minting

get

This endpoint provides the necessary contract addresses required for minting a specific token. It includes addresses for token and sale contracts, which are crucial for the tokenization process. This information is vital for developers and administrators managing token minting operations.

Authorizations
Path parameters
tokenIdstringRequired

Token identifier

Responses
200
Contract addresses retrieved successfully
application/json
get
GET /api/v/1/config/contract-addresses/{tokenId} HTTP/1.1
Host: localhost:5004
x-api-key: YOUR_API_KEY
Accept: */*
200

Contract addresses retrieved successfully

{
  "status": "SUCCESS",
  "response": {
    "config": {
      "tokenContract": "text",
      "saleContract": "text"
    }
  }
}

Last updated

Was this helpful?