Explore artworks

Searches artworks with filters and sorting. Returns 30 per page. Results are cached for 5 minutes.

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

page*integer

Zero-based page index. Page size is fixed at 30 on this endpoint.

Range0 <= value

sort*ExploreSort

Ordering applied to artwork results. trending and most-liked-24h are windowed over recent activity; lowest-price and ending-soon only meaningfully order listed artworks; recent-activity ranks by the most recent event of any kind.

Value in

"recently-listed"
"recently-sold"
"trending"
"ending-soon"
"most-liked"
"most-liked-24h"
"alphabetical"
"lowest-price"
"recent-activity"

filter?

Filter object. Unrecognized keys are ignored, so new filters can be added without breaking existing callers. A known key with the wrong type is rejected with a 400.

Response Body

`application/json`

curl -X POST "https://example.com/v1/artworks/explore" \  -H "Content-Type: application/json" \  -d '{    "page": 0,    "sort": "recently-listed"  }'

{  "result": [    {      "mintAccount": "string",      "name": "string",      "image": "string"    }  ]}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`