Skip to main content
GET
Get a specific STO by its UUID
Requires x-api-key. Returns the full record for a single offering — supply, price, dates, status, and the associated token. Your key must be the tokenizer of the token behind the offering, or the call returns Unauthorized token symbol. See Authentication. Use GET /get-stos to list every offering for a token and discover the IDs.

Authorizations

x-api-key
string
header
required

Query Parameters

tokenSymbol
string
required

The symbol of the token.

id
string<uuid>
required

The unique identifier (UUID) of the STO.

Response

200 - application/json

Successful response - STO details retrieved

Represents the structure of an STO based on the defined interface.

uuid
string<uuid>
required

Unique identifier of the STO.

Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

name
string
required

Name of the STO.

Example:

"Example Project Alpha STO"

status
string
required

Current status of the STO (e.g., UPCOMING, ACTIVE, COMPLETED).

Example:

"ACTIVE"

tokenAmount
string
required

Total amount of tokens offered in the STO (as a string).

Example:

"1000000"

hardCap
string
required

The hard cap funding goal (as a string).

Example:

"500000"

softCap
string
required

The soft cap funding goal (as a string).

Example:

"100000"

maxInvestment
string
required

Maximum allowed investment per participant (as a string).

Example:

"10000"

minInvestment
string
required

Minimum required investment per participant (as a string).

Example:

"100"

tokenSymbol
string
required

Symbol for the token being offered.

Example:

"EXA"

startDate
string<date-time>
required

The STO start date and time in ISO 8601 format.

Example:

"2025-04-01T10:00:00.000Z"

endDate
string<date-time>
required

The STO end date and time in ISO 8601 format.

Example:

"2025-07-01T23:59:59.000Z"

tokenPrice
string
required

Price per token (as a string).

Example:

"0.50"

acceptedCoin
string
required

The symbol of the accepted cryptocurrency for payment.

Example:

"USDC"