Developers

Based Punks Dev Kit

A free, public, CORS-enabled API that returns the full onchain identity of any Based OnChain Punk — image, traits, owner, rarity and a ready-made persona prompt. Build AI agents, Discord bots, web widgets, or anything else that needs a punk's identity.

Endpoint

GET https://basedpunks.com/api/public/punks/{tokenId}/manifest

Rate-limited to 120 requests per minute per IP. No API key required. Returns 404 for unknown token IDs.

Response shape

{
  "name": "Based OnChain Punk #1234",
  "tokenId": 1234,
  "image": "https://basedpunks.com/api/identity/1234/image",
  "contract": "0x...",
  "chain": "base",
  "chainId": 8453,
  "owner": "0x...",
  "rarityRank": 482,
  "traits": [
    { "trait_type": "Type", "value": "Male" },
    { "trait_type": "Hair", "value": "Mohawk" }
  ],
  "persona": "You are Based OnChain Punk #1234. Traits: ...",
  "source": "onchain"
}

curl

curl https://basedpunks.com/api/public/punks/1234/manifest

JavaScript / TypeScript

const res = await fetch(
  "https://basedpunks.com/api/public/punks/1234/manifest",
);
const manifest = await res.json();
console.log(manifest.persona);

Image endpoint

A standalone PNG version of the punk image is also available, suitable for direct use as a profile picture URL.

GET https://basedpunks.com/api/identity/{tokenId}/image?size=1024

In-app Dev Kit

Open any punk page and click Developer Kit to get a ready-to-paste TypeScript snippet, persona prompt, and a one-click Claude plugin.

Browse Punks →