Honeycluster Docs – Get CDN asset URLs for multiple NFTs

nftokens

Get CDN asset URLs for multiple NFTs

post

/nft/assets/urls/batch

operationId: nft-getBatchAssetUrls

Returns a map from tokenId to its list of fetched CDN assets for up to 100 tokens per request. Missing or unfetched tokens appear as empty arrays, so callers can count on every requested ID being present in the response. Use this instead of N parallel calls to /nft/assets/urls.

Authorizations

Name	Location	Details
`BearerAuth`	Authorization header · bearer	JWT issued by the Honeycluster auth service for the `indexer` audience. Present as `Authorization: Bearer <token>`.

Request Body

application/json

required

Field	Type	Description
`tokenIds` required	string[]	List of NFToken identifiers to look up (max 100).

Example

Json

{
  "tokenIds": [
    "string"
  ]
}

Responses

200

application/json

Successful response

Field	Type	Description
`results`	object	Map from tokenId to the list of CDN assets for that token.

Example

Json

{
  "results": {
    "00081388A20EAE7B7B6C32CB7C3F0A4F02D0D8D4E0D0E0F0CEE12345678ABCDEF": [
      {
        "type": "image",
        "cdnUrl": "https://cdn.honeycluster.dev/nfts/00081388/main.png",
        "contentType": "image/png",
        "fileSize": 524288
      }
    ]
  }
}

400

application/json

Invalid input data

Field	Type	Description
`message`	string	The error message
`code`	string	The error code
`issues`	object[]	An array of issues that were responsible for the error
`issues[].message`	string

Example

Json

{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}

401

application/json

Authorization not provided

Field	Type	Description
`message`	string	The error message
`code`	string	The error code
`issues`	object[]	An array of issues that were responsible for the error
`issues[].message`	string

Example

Json

{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}

403

application/json

Insufficient access

Field	Type	Description
`message`	string	The error message
`code`	string	The error code
`issues`	object[]	An array of issues that were responsible for the error
`issues[].message`	string

Example

Json

{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}

500

application/json

Internal server error

Field	Type	Description
`message`	string	The error message
`code`	string	The error code
`issues`	object[]	An array of issues that were responsible for the error
`issues[].message`	string

Example

Json

{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}