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}' \