jinsley8 / doodles-subgraph-api

Subgraph to query Doodles NFT tokens along with the traits and owners.

Doodles Subgraph API

Subgraph to query Doodles NFT tokens along with the traits and owners.

How to use the API

Try it out here

Example query:

{
  tokens(first: 5) {
    id
    tokenID
    tokenURI
    image
    name
    description
    face
    hair
    body
    background
    head
    piercing
    updatedAtTimestamp 
    owner {
      id 
    }
  }
}

Filtering

{
  tokens(
    where: {
      face_contains: "mustache"
    }
  ) {
    face
    name
    tokenID
    owner {
      id 
    }
  }
}

Full text search

{
  doodleSearch(
    text: "'mustache'"
  ) {
    id
    name
    description
  }
}

How to deploy the API

This project is an example of how you can build and deploy Graph Protocol APIs for NFT projects.

This subgraph indexes data from doodles smart contract transactions and makes them queryable.

This API enables advanced querying capabilities like full text search, relationships between tokens and users, filtering, sorting, and pagination.

To deploy this API, follow these steps:

1. Clone this repo, change into the directory, and install the dependencies:

git clone [e-mail]:jinsley8/doodles-subgraph-api.git

cd doodles-subgraph-api

npm install

2. Visit The Graph hosted service dashboard, create a profile, and create a new subgraph by clicking Add Subgraph.

3. Install The Graph CLI:

npm install -g @graphprotocol/graph-cli

4. Authenticate the your CLI environment with the Access Token from your account dashboard:

graph auth https://api.thegraph.com/deploy/ <ACCESS_TOKEN>

5. Replace username/apiname in package.json with your username and apiname, for example: jinsley8/doodles-api

6. Deploy the subgraph

yarn deploy