POST
/
offering
curl --request POST \
  --url https://api.decentri.org/offering \
  --header 'Content-Type: application/json' \
  --data '{
  "tokenId": "0x1234567890987654321",
  "imageUrl": "https://example.com/image.png",
  "title": "Decentri Fund",
  "subtitle": "Decentralized investment fund",
  "description": "A decentralized investment fund",
  "type": "Equity",
  "pricePerToken": 100,
  "offeringPeriod": {
    "startDate": "2025-09-01T00:00:00Z",
    "endDate": "2025-09-30T23:59:59Z"
  },
  "investmentLimits": {
    "minInvestment": 1000,
    "maxInvestment": 10000,
    "hardCap": 100000,
    "softCap": 100000
  }
}'
{
  "offeringId": "cmVhY3Rpb24vMTIzNA75",
  "title": "Decentri Fund",
  "subtitle": "Decentralized investment fund",
  "description": "A decentralized investment fund",
  "token": {
    "name": "ACME Token",
    "symbol": "ACME",
    "address": "0xc0ffee254729296a45a3885639AC7E10F9d54979",
    "decimals": 18,
    "owner": "0x999999cf1046e68e36E1aA2E0E07105eDDD1f08E",
    "isPaused": false,
    "createdAt": "2023-11-07T05:31:56Z"
  },
  "imageUrl": "https://example.com/image.png",
  "type": "Equity",
  "pricePerToken": 100,
  "offeringPeriod": {
    "startDate": "2021-09-01T00:00:00Z",
    "endDate": "2021-09-30T23:59:59Z"
  },
  "investmentLimits": {
    "minInvestment": 1000,
    "maxInvestment": 10000,
    "hardCap": 100000,
    "softCap": 100000,
    "currentlyInvested": 1000
  }
}

Body

application/json
tokenId
string
required

The token ID

Example:

"0x1234567890987654321"

title
string
required

The title of the offering

Example:

"Decentri Fund"

pricePerToken
number
required

The price per token

Example:

100

offeringPeriod
object
required

The offering period

investmentLimits
object
required

The investment limits

imageUrl
string

The URL of the image

Example:

"https://example.com/image.png"

subtitle
string

The subtitle of the offering

Example:

"Decentralized investment fund"

description
string

The description of the offering

Example:

"A decentralized investment fund"

type
string

The type of the offering

Example:

"Equity"

Response

200
application/json
The offering has been successfully retrieved
offeringId
string
required

The offering ID

Example:

"cmVhY3Rpb24vMTIzNA75"

title
string
required

The title of the offering

Example:

"Decentri Fund"

token
object
required

The token of the offering

pricePerToken
number
required

The price per token

Example:

100

offeringPeriod
object
required

The offering period

investmentLimits
object
required

The investment limits

subtitle
string

The subtitle of the offering

Example:

"Decentralized investment fund"

description
string

The description of the offering

Example:

"A decentralized investment fund"

imageUrl
string

The URL of the image

Example:

"https://example.com/image.png"

type
string

The type of the offering

Example:

"Equity"