User

/v1/user

Get user

Returns a Matrica user by their username.

Find a user by username.

get

/user/{username}

Path parameters

usernamestring · min: 1required

Query parameters

apiKeystring · min: 4required

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.matrica.io/v1/user/{username}?apiKey=text'

200

400

404

200

No body

Returns the user.

Returns a Matrica user's profile.

Get NFT Collection Counts for a User

Returns the count of NFTs a user owns in specific collections. This route is Enterprise only.

Get NFT collection counts for a user.

get

/v1/user/{userId}/nft-collections

Path parameters

userIdstringrequired

The ID of the user whose NFT collections are to be retrieved.

Query parameters

collectionIdstring

Optional filter to retrieve NFTs for a specific collection.

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/user/{userId}/nft-collections'

200

400

200

[
  {
    "collectionId": "3469c345-04db-4d19-b207-7fa1138dd940",
    "collectionName": "Matrica Pixels",
    "count": 5
  },
  {
    "collectionId": "e11bbb2a-a8e7-4a79-b9e4-32e8f34749dd",
    "collectionName": "Matrica Blocks",
    "count": 8
  }
]

Returns the NFT collection counts for the user.

Get user PFP.

get

https://api.matrica.io/v1/user/{userId}/pfp

Path parameters

userIdstringrequired

The ID of the user

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.matrica.io/v1/user/{userId}/pfp'

200

200

{
  "collectionName": "Bored Ape Yacht Club",
  "collectionPfp": "https://example.com/collection-pfp.jpg",
  "pfpNFTId": "123",
  "pfpNFTUrl": "https://example.com/nft-image.jpg"
}

Returns the user PFP.