— projects submitted

Build With
10,000 On-Chain Faces

The Normies Hackathon is open. Use our free API to access pixel data, traits, images, metadata, and ownership for every Normie — then build something amazing.

Submit Your Project Explore the API
Free API Access
100% On-Chain Data
AI-Agent Ready

What is this

The Normies Hackathon

Build Anything

Games, tools, visualizations, social apps, analytics dashboards, AI experiments — if it uses the Normies API, it counts. No restrictions on what you build.

AI-Agent Friendly

We provide LLM-ready documentation you can paste directly into ChatGPT, Claude, Cursor, or any AI agent. Let AI help you build with Normies faster.

Win Prizes

Prizes for the most creative, most useful, and most technically impressive projects. Details announced soon. All skill levels welcome.

What data do you get?

■
Pixel Bitmaps
40x40 monochrome per Normie
■
Traits & Metadata
8 categories, human-readable
■
SVG & PNG Images
On-chain rendered, pixel-perfect
■
Ownership & History
Holders, burns, transforms

API Reference

Everything You Need

All endpoints are free to use. No API key required. Data sourced directly from Ethereum mainnet smart contracts.

Base URL

https://api.normies.art
GET
/normie/:id/pixels

40x40 bitmap as 1600-char binary string

GET
/normie/:id/traits

Decoded traits as JSON with human-readable labels

GET
/normie/:id/traits/binary

Raw bytes8 trait data as hex string

GET
/normie/:id/image.svg

Normie as SVG (1000x1000, matches on-chain renderer)

GET
/normie/:id/image.png

Normie as 1000x1000 PNG, pixel-perfect rasterization

GET
/normie/:id/metadata

Full NFT metadata JSON (V4 renderer, canvas-aware)

GET
/normie/:id/original/*

Original endpoints (pixels, image.svg, image.png) — pre-Canvas data

Full API documentation

For AI Agents

LLM-Ready Documentation

Copy the full API documentation in a format optimized for large language models. Paste it into ChatGPT, Claude, Cursor, or any AI coding assistant to start building with Normies instantly.

llms.txt
Open Raw 

        

      


      

        

          
1

          
Copy the docs above

        

        

          
2

          
Paste into your AI agent

        

        

          
3

          
Ask it to build something

        

      

    

  


  
  

    

      

        
Try it live

        
Preview Any Normie

        
Enter a token ID (0–9999) to see the API in action.

      


      

        

          
          
        


        

          Normie #0
          
Normie #0

          

        

      

    

  


  
  

    

      

        
Submit

        
Submit Your Project

        
Built something with the Normies API? Submit it here. Include a demo link so judges can try it out.

      


      

        

          

            

              
              
            

            

              
              
            

          


          

            
            
          


          

            
            
          


          

            

              
              
            

            

              
              
            

          


          

            
            
          


          

            
            
          


          

            
            
          


          
        


        
      

    

  


  
  

    

      

        
FAQ

        
Common Questions

      


      

        

          
            Do I need to own a Normie to participate?
            
          
          
No! The API is completely free and open. You can access pixel data, traits, images, and metadata for all 10,000 Normies without owning any. The hackathon is open to everyone.

        


        

          
            What can I build?
            
          
          
Anything that uses the Normies API. Games, tools, art generators, analytics dashboards, social apps, AI experiments, browser extensions, bots — there are no restrictions on what you can create. Be creative!

        


        

          
            Can I use AI to help me build?
            
          
          
Absolutely! We encourage it. We provide LLM-ready documentation specifically for this purpose. Copy the docs from the "LLM Docs" section above and paste them into ChatGPT, Claude, Cursor, or any AI coding assistant to get started immediately.

        


        

          
            Is there a rate limit?
            
          
          
Yes, 60 requests per minute per IP address (sliding window). This should be more than enough for most applications. Rate limit headers are included in every response so you can track your usage.

        


        

          
            Do I need an API key?
            
          
          
No. The API is completely open — no authentication, no API keys, no sign-up required. Just start making requests.

        


        

          
            Can I participate as a team?
            
          
          
Yes! Solo builders and teams are both welcome. Just submit one entry per project.

        


        

          
            What are the judging criteria?
            
          
          
Projects will be evaluated on creativity, technical execution, use of the Normies API, and overall polish. We're looking for projects that are fun, useful, or push the boundaries of what's possible with on-chain data.