NFTs

List NFT collections

get

https://sandbox.sverse.iohttps://open.sverse.io

/v1/nfts/collections

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

projectIdstringOptional

chainKeystringOptional

cursorstringOptional

limitinteger · min: 1 · max: 200OptionalDefault: 50

Responses

200

Collections list

application/json

get

/v1/nfts/collections

HTTPcURLJavaScriptPython

GET /v1/nfts/collections HTTP/1.1
Host: sandbox.sverse.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Collections list

{
  "items": [
    {
      "id": "col_01HXYZ...",
      "projectId": "text",
      "chainKey": "eth-mainnet",
      "tokenStandard": "erc721",
      "contractAddress": "text",
      "name": "text",
      "description": "text",
      "status": "active",
      "createdAt": "2026-01-19T11:19:09.886Z",
      "metadata": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ],
  "page": {
    "nextCursor": "text"
  }
}

Create an NFT collection (on-chain aware)

post

https://sandbox.sverse.iohttps://open.sverse.io

/v1/nfts/collections

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

projectIdstringRequired

chainKeystringRequired

tokenStandardstring · enumRequiredPossible values:

namestringRequired

descriptionstring | nullableOptional

contractAddressstring | nullableOptional

If already deployed, provide contract address. Otherwise, Sverse may deploy (optional).

Responses

201

Collection created

application/json

post

/v1/nfts/collections

HTTPcURLJavaScriptPython

POST /v1/nfts/collections HTTP/1.1
Host: sandbox.sverse.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 173

{
  "projectId": "text",
  "chainKey": "text",
  "tokenStandard": "erc721",
  "name": "text",
  "description": "text",
  "contractAddress": "text",
  "metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

201

Collection created

{
  "id": "col_01HXYZ...",
  "projectId": "text",
  "chainKey": "eth-mainnet",
  "tokenStandard": "erc721",
  "contractAddress": "text",
  "name": "text",
  "description": "text",
  "status": "active",
  "createdAt": "2026-01-19T11:19:09.886Z",
  "metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

Mint an NFT item (multi-chain)

post

https://sandbox.sverse.iohttps://open.sverse.io

/v1/nfts/collections/{collectionId}/items

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

collectionIdstringRequired

Body

application/json

ownerWalletIdstringRequired

metadataUristring | nullableOptional

idempotencyKeystring | nullableOptional

Responses

201

Mint initiated

application/json

post

/v1/nfts/collections/{collectionId}/items

HTTPcURLJavaScriptPython

POST /v1/nfts/collections/{collectionId}/items HTTP/1.1
Host: sandbox.sverse.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 121

{
  "ownerWalletId": "text",
  "metadataUri": "text",
  "attributes": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "idempotencyKey": "text"
}

201

Mint initiated

{
  "transaction": {
    "id": "tx_01HXYZ...",
    "projectId": "text",
    "type": "transfer",
    "status": "pending",
    "createdAt": "2026-01-19T11:19:09.886Z",
    "chainKey": "eth-mainnet",
    "onchainTxHash": "text",
    "confirmations": 1,
    "explorerUrl": "text",
    "fromWalletId": "text",
    "toWalletId": "text",
    "currencyCode": "text",
    "amount": "text",
    "reference": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  },
  "nft": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}