#Introduction
Access all 10,000 CryptoPunks, individual traits, and generate custom combinations with pixel-perfect rendering.
REST APIJSON / PNG / SVGASCII / ANSI
#Endpoints
GET
/traitsGet all available traits with basic info.
| Parameter | Description |
|---|---|
| category | Filter by category (Background, Eyewear, etc.) |
| gender | Filter by gender (Male, Female, Unisex) |
| search | Search traits by name |
| extended | Include extended traits (unisex versions) |
| limit | Limit number of results (default: all) |
| offset | Pagination offset |
| groupByCategory | Group results by category (true/false) |
Example Request
GET /api/traits?category=Hairstyle&gender=Female&limit=5
GET
/traits/[slug]Get specific trait data or combine multiple traits (dash-separated).
| Parameter | Description |
|---|---|
| format | json (default), pixels, svg, png, ascii, ansi |
| size | Image size (pixels). Default 24, or 32 for naked mode. |
| background | Color name, hex, gradient (dash-separated), or image URL |
| naked | Enable naked body mode: yes, true, 1 |
| dingdong | Add basic anatomical details (requires naked=yes): yes, true, 1 |
| ribbon | Add green corner ribbon (png only) |
GET
/punksList CryptoPunks with token IDs and traits.
| Parameter | Description |
|---|---|
| limit | Limit number of results |
| offset | Pagination offset |
| includeTraits | Include trait data (default: true). Set to false for lighter response. |
Example Request
GET /api/punks?limit=10&offset=500
GET
/punks/[id]Get a specific CryptoPunk by ID.
| Parameter | Description |
|---|---|
| format | json (default), pixels, svg, png, ascii, ansi |
| size | Image size (pixels). Default 24, or 32 for naked mode. |
| background | Color name, hex, gradient (dash-separated), or image URL |
| naked | Enable naked body mode: yes, true, 1 |
| dingdong | Add anatomical details. Values: yes, tripod, in-a-sock, tripod-in-a-sock |
| socks | Add socks (requires naked=yes). Values: yes, or hex color (e.g. ff0000) |
| nips | Special nipple styles. Value: clown |
| ribbon | Add green corner ribbon (png only) |
#Visuals & Formats
Naked Mode
Expand the canvas to 32x32 and generate anatomically correct bodies. Supports automatic skin tone matching, clothing removal, and gender-specific anatomy.
naked=yes&dingdong=tripod&socks=ff0000
ASCII & ANSI
Generate text-based art for terminals and chat.
format=ascii | format=ansi
Loading examples...
#Colors
Use the background parameter with hex codes, CSS names, gradients (dash-separated), or our punk presets.
punk
#638696
v1
#A89CFF
forsale
#95554F
bids
#8E6FB6
wrapped1
#C8DFCA
wrapped2
#67A670
Built by gwendall
Free to use • Credit appreciated