Core Resources
- Tokens
- Customers
- Offerings
- Offering Purchase Intents
- Transactions
- Holders
- Organizations
- Wallets
- Offers
Offers
Create an offer
Create an offer to either buy or sell tokens. The offer includes the token, amount, price, and direction (buy or sell).
POST
/
bulletin-board
/
offer
Copy
curl --request POST \
--url https://api.decentri.org/bulletin-board/offer \
--header 'Content-Type: application/json' \
--data '{
"tokenId": "0xF01234567890abcdef1234567890ABCDEF123456",
"customerId": "customer_82bd7ffb54c24d2bb76c45f1d759b0ce",
"makerWalletId": "wallet_45ac7617d40e46b3b30ff97b091d6f78",
"makerWalletAddress": "0x3eB0e9C2Cd65d4325795AB8FAd3a69b3B2f8583f",
"amount": 10,
"priceInEuro": 500,
"intention": "SELL"
}'
Copy
{
"tokenId": "0xabc1234567890def1234567890abcdef12345678",
"makerWalletAddress": "0x12b5aEDEb98767823Dd473bE7C88A8203FaA7Ee8",
"takerWalletAddress": "0xA74269C3DE980723A1D49a017cBbD1839C41D4e7",
"amount": 5,
"priceInEuro": 250.75,
"status": "OPEN",
"intention": "BUY",
"maker": {
"id": "customer_c7a968e665d9",
"object": "customer",
"name": "John Doe",
"email": "john.doe@example.com",
"phone": "+1234567890",
"metadata": {
"userId": "2b634b51-7f4a-470b-9bd6-c7a968e665d9"
},
"address": {
"line1": "1234 Main St",
"line2": "Suite 200",
"city": "Anytown",
"state": "CA",
"postalCode": "12345",
"countryCode": "US"
},
"verificationStatus": "IN_PROGRESS",
"wallets": [
{
"address": "0x1234567890123456789012345678901234567890",
"object": "wallet",
"balances": {
"token": "0x4dad19801eff64eaaa7c78e466ce3678d0b1fd94",
"total": "1000",
"available": {
"amount": "0"
},
"frozen": {
"amount": "1000"
}
}
}
],
"type": "INDIVIDUAL",
"countryCode": "US"
},
"taker": {
"id": "customer_c7a968e665d9",
"object": "customer",
"name": "John Doe",
"email": "john.doe@example.com",
"phone": "+1234567890",
"metadata": {
"userId": "2b634b51-7f4a-470b-9bd6-c7a968e665d9"
},
"address": {
"line1": "1234 Main St",
"line2": "Suite 200",
"city": "Anytown",
"state": "CA",
"postalCode": "12345",
"countryCode": "US"
},
"verificationStatus": "IN_PROGRESS",
"wallets": [
{
"address": "0x1234567890123456789012345678901234567890",
"object": "wallet",
"balances": {
"token": "0x4dad19801eff64eaaa7c78e466ce3678d0b1fd94",
"total": "1000",
"available": {
"amount": "0"
},
"frozen": {
"amount": "1000"
}
}
}
],
"type": "INDIVIDUAL",
"countryCode": "US"
}
}
Body
application/json
Response
201
application/json
Offer created successfully.
The response is of type object
.
Copy
curl --request POST \
--url https://api.decentri.org/bulletin-board/offer \
--header 'Content-Type: application/json' \
--data '{
"tokenId": "0xF01234567890abcdef1234567890ABCDEF123456",
"customerId": "customer_82bd7ffb54c24d2bb76c45f1d759b0ce",
"makerWalletId": "wallet_45ac7617d40e46b3b30ff97b091d6f78",
"makerWalletAddress": "0x3eB0e9C2Cd65d4325795AB8FAd3a69b3B2f8583f",
"amount": 10,
"priceInEuro": 500,
"intention": "SELL"
}'
Copy
{
"tokenId": "0xabc1234567890def1234567890abcdef12345678",
"makerWalletAddress": "0x12b5aEDEb98767823Dd473bE7C88A8203FaA7Ee8",
"takerWalletAddress": "0xA74269C3DE980723A1D49a017cBbD1839C41D4e7",
"amount": 5,
"priceInEuro": 250.75,
"status": "OPEN",
"intention": "BUY",
"maker": {
"id": "customer_c7a968e665d9",
"object": "customer",
"name": "John Doe",
"email": "john.doe@example.com",
"phone": "+1234567890",
"metadata": {
"userId": "2b634b51-7f4a-470b-9bd6-c7a968e665d9"
},
"address": {
"line1": "1234 Main St",
"line2": "Suite 200",
"city": "Anytown",
"state": "CA",
"postalCode": "12345",
"countryCode": "US"
},
"verificationStatus": "IN_PROGRESS",
"wallets": [
{
"address": "0x1234567890123456789012345678901234567890",
"object": "wallet",
"balances": {
"token": "0x4dad19801eff64eaaa7c78e466ce3678d0b1fd94",
"total": "1000",
"available": {
"amount": "0"
},
"frozen": {
"amount": "1000"
}
}
}
],
"type": "INDIVIDUAL",
"countryCode": "US"
},
"taker": {
"id": "customer_c7a968e665d9",
"object": "customer",
"name": "John Doe",
"email": "john.doe@example.com",
"phone": "+1234567890",
"metadata": {
"userId": "2b634b51-7f4a-470b-9bd6-c7a968e665d9"
},
"address": {
"line1": "1234 Main St",
"line2": "Suite 200",
"city": "Anytown",
"state": "CA",
"postalCode": "12345",
"countryCode": "US"
},
"verificationStatus": "IN_PROGRESS",
"wallets": [
{
"address": "0x1234567890123456789012345678901234567890",
"object": "wallet",
"balances": {
"token": "0x4dad19801eff64eaaa7c78e466ce3678d0b1fd94",
"total": "1000",
"available": {
"amount": "0"
},
"frozen": {
"amount": "1000"
}
}
}
],
"type": "INDIVIDUAL",
"countryCode": "US"
}
}
Assistant
Responses are generated using AI and may contain mistakes.