List Collections

curl --request POST \
  --url https://api.storyapis.com/api/v4/collections \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "orderBy": "updatedAt",
  "orderDirection": "desc",
  "pagination": {
    "limit": 20,
    "offset": 0
  },
  "where": {
    "collectionAddresses": [
      "<string>"
    ],
    "maxAssetCount": 1,
    "minAssetCount": 1
  }
}
'

{
  "data": [
    {
      "assetCount": 123,
      "cancelledDisputeCount": 123,
      "collectionAddress": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "judgedDisputeCount": 123,
      "licensesCount": 123,
      "raisedDisputeCount": 123,
      "resolvedDisputeCount": 123,
      "updatedAt": "2023-11-07T05:31:56Z",
      "collectionMetadata": {
        "address": "<string>",
        "chain": "<string>",
        "contractDeployer": "<string>",
        "deployedBlockNumber": 123,
        "name": "<string>",
        "openSeaMetadata": {
          "bannerImageUrl": "<string>",
          "collectionName": "<string>",
          "collectionSlug": "<string>",
          "description": "<string>",
          "discordUrl": "<string>",
          "externalUrl": "<string>",
          "floorPrice": 123,
          "imageUrl": "<string>",
          "lastIngestedAt": "2023-11-07T05:31:56Z",
          "safelistRequestStatus": "<string>",
          "twitterUsername": "<string>"
        },
        "symbol": "<string>",
        "tokenType": "<string>",
        "totalSupply": "<string>"
      }
    }
  ],
  "$schema": "<string>",
  "pagination": {
    "hasMore": true,
    "limit": 123,
    "offset": 123,
    "total": 123
  }
}

Endpoints

List Collections

Retrieve a list of collections with pagination and filtering options. Collections can be ordered by updatedAt, assetCount, or licensesCount (asc/desc). Collections are automatically enriched with metadata. The ‘where’ field is optional and should only be provided when filtering by specific collection addresses or asset counts. This endpoint can also be used to fetch a single collection by passing its address in the collectionAddresses filter. Collections that don’t exist in Alchemy or encounter errors will return with empty metadata instead of failing the entire request.

POST

collections

List Collections

curl --request POST \
  --url https://api.storyapis.com/api/v4/collections \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "orderBy": "updatedAt",
  "orderDirection": "desc",
  "pagination": {
    "limit": 20,
    "offset": 0
  },
  "where": {
    "collectionAddresses": [
      "<string>"
    ],
    "maxAssetCount": 1,
    "minAssetCount": 1
  }
}
'

{
  "data": [
    {
      "assetCount": 123,
      "cancelledDisputeCount": 123,
      "collectionAddress": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "judgedDisputeCount": 123,
      "licensesCount": 123,
      "raisedDisputeCount": 123,
      "resolvedDisputeCount": 123,
      "updatedAt": "2023-11-07T05:31:56Z",
      "collectionMetadata": {
        "address": "<string>",
        "chain": "<string>",
        "contractDeployer": "<string>",
        "deployedBlockNumber": 123,
        "name": "<string>",
        "openSeaMetadata": {
          "bannerImageUrl": "<string>",
          "collectionName": "<string>",
          "collectionSlug": "<string>",
          "description": "<string>",
          "discordUrl": "<string>",
          "externalUrl": "<string>",
          "floorPrice": 123,
          "imageUrl": "<string>",
          "lastIngestedAt": "2023-11-07T05:31:56Z",
          "safelistRequestStatus": "<string>",
          "twitterUsername": "<string>"
        },
        "symbol": "<string>",
        "tokenType": "<string>",
        "totalSupply": "<string>"
      }
    }
  ],
  "$schema": "<string>",
  "pagination": {
    "hasMore": true,
    "limit": 123,
    "offset": 123,
    "total": 123
  }
}

Authorizations

X-Api-Key

string

header

required

Body

application/json

orderBy

enum<string>

default:updatedAt

Field to order results by: updatedAt, assetCount, or licensesCount

Available options:

updatedAt,

assetCount,

licensesCount

orderDirection

enum<string>

default:desc

Order direction: asc for least recent, desc for most recent

Available options:

asc,

desc

pagination

object

Pagination configuration

Show child attributes

pagination.limit

integer<int64>

default:20

Number of items to return

Required range: 1 <= x <= 200

pagination.offset

integer<int64>

default:0

Number of items to skip

Required range: x >= 0

where

object

Optional filter options for collections

Show child attributes

where.collectionAddresses

string[] | null

List of collection addresses to filter by (max 200)

Maximum array length: 200

where.maxAssetCount

integer<int64>

Maximum asset count threshold

Required range: x >= 0

where.minAssetCount

integer<int64>

Minimum asset count threshold

Required range: x >= 0

Response

data

object[] | null

required

List of enriched collections

Show child attributes

data.assetCount

integer<int64>

required

data.cancelledDisputeCount

integer<int64>

required

data.collectionAddress

string

required

data.createdAt

string<date-time>

required

data.judgedDisputeCount

integer<int64>

required

data.licensesCount

integer<int64>

required

data.raisedDisputeCount

integer<int64>

required

data.resolvedDisputeCount

integer<int64>

required

data.updatedAt

string<date-time>

required

data.collectionMetadata

object

Show child attributes

data.collectionMetadata.address

string

required

data.collectionMetadata.chain

string

required

data.collectionMetadata.contractDeployer

string

required

data.collectionMetadata.deployedBlockNumber

integer<int64>

required

data.collectionMetadata.name

string

required

data.collectionMetadata.openSeaMetadata

object

required

Show child attributes

data.collectionMetadata.openSeaMetadata.bannerImageUrl

string

required

data.collectionMetadata.openSeaMetadata.collectionName

string

required

data.collectionMetadata.openSeaMetadata.collectionSlug

string

required

data.collectionMetadata.openSeaMetadata.description

string

required

data.collectionMetadata.openSeaMetadata.discordUrl

string

required

data.collectionMetadata.openSeaMetadata.externalUrl

string | null

required

data.collectionMetadata.openSeaMetadata.floorPrice

number<double>

required

data.collectionMetadata.openSeaMetadata.imageUrl

string

required

data.collectionMetadata.openSeaMetadata.lastIngestedAt

string<date-time>

required

data.collectionMetadata.openSeaMetadata.safelistRequestStatus

string

required

data.collectionMetadata.openSeaMetadata.twitterUsername

string

required

data.collectionMetadata.symbol

string

required

data.collectionMetadata.tokenType

string

required

data.collectionMetadata.totalSupply

string

required

$schema

string<uri>

A URL to the JSON Schema for this object.

pagination

object

Pagination metadata

Show child attributes

pagination.hasMore

boolean

required

Whether there are more items

pagination.limit

integer<int64>

required

Current limit

pagination.offset

integer<int64>

required

Current offset

pagination.total

integer<int64>

required

Total count of items

List IP Asset Edges List Disputes

⌘I

Protocol API Overview

Endpoints

Authorizations

Body

Response