API / Listings
Public endpoints for all tokens for sale in the primary and secondary marketplaces.
Listings
/v2/api/listings/ (GET)
Headers
Header |
Value |
Description |
curios-api-key |
{API Key} |
API Key for your licence account, retrieve from your admin dashboard. |
curios-date |
{UTC Date/Time Stamp} |
API Key for your licence account, retrieve from your admin dashboard. |
curios-signature |
{Signature} |
A calculated signature, see instructions here. |
Body
Argument |
Value |
Required |
Description |
curl --location --request GET 'https://api.curios.com/v2/api/listings/' \
--header 'curios-api-key: {API Key}' \
--header 'curios-date: {UTC Date/Time Stamp}' \
--header 'curios-signature: {Signature}' \
Listing Details
/v2/api/listings/:id (GET)
Headers
Header |
Value |
Description |
curios-api-key |
{API Key} |
API Key for your licence account, retrieve from your admin dashboard. |
curios-date |
{UTC Date/Time Stamp} |
API Key for your licence account, retrieve from your admin dashboard. |
curios-signature |
{Signature} |
A calculated signature, see instructions here. |
Body
Argument |
Value |
Required |
Description |
curl --location --request GET 'https://api.curios.com/v2/api/listings/:id' \
--header 'curios-api-key: {API Key}' \
--header 'curios-date: {UTC Date/Time Stamp}' \
--header 'curios-signature: {Signature}' \
Listing Bids
/v2/api/listings/:id/bids (GET)
Headers
Header |
Value |
Description |
curios-api-key |
{API Key} |
API Key for your licence account, retrieve from your admin dashboard. |
curios-date |
{UTC Date/Time Stamp} |
API Key for your licence account, retrieve from your admin dashboard. |
curios-signature |
{Signature} |
A calculated signature, see instructions here. |
Body
Argument |
Value |
Required |
Description |
curl --location --request GET 'https://api.curios.com/v2/api/listings/:id/bids' \
--header 'curios-api-key: {API Key}' \
--header 'curios-date: {UTC Date/Time Stamp}' \
--header 'curios-signature: {Signature}' \
Listing Current Bid
/v2/api/listings/:id/bids/current (GET)
Headers
Header |
Value |
Description |
curios-api-key |
{API Key} |
API Key for your licence account, retrieve from your admin dashboard. |
curios-date |
{UTC Date/Time Stamp} |
API Key for your licence account, retrieve from your admin dashboard. |
curios-signature |
{Signature} |
A calculated signature, see instructions here. |
Body
Argument |
Value |
Required |
Description |
curl --location --request GET 'https://api.curios.com/v2/api/listings/:id/bids/current' \
--header 'curios-api-key: {API Key}' \
--header 'curios-date: {UTC Date/Time Stamp}' \
--header 'curios-signature: {Signature}' \
Listing Add Bid
/v2/api/listings/:id/bids/create (PUT)
Headers
Header |
Value |
Description |
curios-api-key |
{API Key} |
API Key for your licence account, retrieve from your admin dashboard. |
curios-date |
{UTC Date/Time Stamp} |
API Key for your licence account, retrieve from your admin dashboard. |
curios-signature |
{Signature} |
A calculated signature, see instructions here. |
Authorization |
Bearer {JWT} |
The JWT session token issued upon succesful customer login and verification. |
Body
Argument |
Value |
Required |
Description |
curl --location --request PUT 'https://api.curios.com/v2/api/listings/:id/bids/create' \
--header 'curios-api-key: {API Key}' \
--header 'curios-date: {UTC Date/Time Stamp}' \
--header 'curios-signature: {Signature}' \
--header 'Authorization: Bearer {JWT}' \
Listings Categories
/v2/api/listings/categories (GET)
Headers
Header |
Value |
Description |
curios-api-key |
{API Key} |
API Key for your licence account, retrieve from your admin dashboard. |
curios-date |
{UTC Date/Time Stamp} |
API Key for your licence account, retrieve from your admin dashboard. |
curios-signature |
{Signature} |
A calculated signature, see instructions here. |
Body
Argument |
Value |
Required |
Description |
curl --location --request GET 'https://api.curios.com/v2/api/listings/categories' \
--header 'curios-api-key: {API Key}' \
--header 'curios-date: {UTC Date/Time Stamp}' \
--header 'curios-signature: {Signature}' \
Listings Category Details
/v2/api/listings/categories/:id (GET)
Headers
Header |
Value |
Description |
curios-api-key |
{API Key} |
API Key for your licence account, retrieve from your admin dashboard. |
curios-date |
{UTC Date/Time Stamp} |
API Key for your licence account, retrieve from your admin dashboard. |
curios-signature |
{Signature} |
A calculated signature, see instructions here. |
Body
Argument |
Value |
Required |
Description |
curl --location --request GET 'https://api.curios.com/v2/api/listings/categories/:id' \
--header 'curios-api-key: {API Key}' \
--header 'curios-date: {UTC Date/Time Stamp}' \
--header 'curios-signature: {Signature}' \