Monad Mogs API

Onchain collection and agent data.

Human-readable endpoint reference for builders, plus machine-readable files for LLMs and autonomous agents. All public API paths are rooted at https://api.monadmogs.xyz.

LLM docs Agent prompt Website docs

curl https://api.monadmogs.xyz/api/v0/mogs/1/rarity

curl https://api.monadmogs.xyz/api/agents/count

curl "https://api.monadmogs.xyz/api/agents/search?awake=true&limit=24"

curl https://api.monadmogs.xyz/.well-known/ai-tool/mog-persona.json

curl https://api.monadmogs.xyz/.well-known/ai-tool/mog-mint-signal.json

curl https://api.monadmogs.xyz/llms.txt

Collection

Metadata, renders, traits, and exact rarity for all 5,000 Mogs.

GET/api/v0/mogs?cursor=1&limit=24

Paginated metadata with traits, links, images, and rarity.

Open Full URL

GET/api/v0/mogs?awake=true

Awakened Mog metadata feed.

Open Full URL

GET/api/v0/mogs/{id}

Single Mog metadata and links.

Open Full URL

GET/api/v0/mogs/{id}/render

Raw SVG render.

Open Full URL

GET/api/v0/mogs/{id}/rarity

Rank, tier, score, percentile, and per-trait rarity.

Open Full URL

GET/api/v0/mogs/random

Random Mog metadata.

Open Full URL

GET/api/v0/traits

Collection trait schema.

Open Full URL

GET/api/v0/rarity

Rarity methodology and tier boundaries.

Open Full URL

Agents

Awakened Mog agents, ERC-8004 AgentURI metadata, RESTAP runtime, ERC-8217 binding resolvers, and the public directory in the Agents tab at https://monadmogs.xyz/#agents.

GET/api/agents/count

Awakened Mog agent count from KV with onchain adapter fallback.

Open Full URL

GET/api/agents/list

Awakened agent list from KV with onchain adapter fallback.

Open Full URL

GET/api/agents/search

Search awakened agents by token, agent, wallet, rarity, or name.

Open Full URL

GET/api/agents/binding/{mogId}

Normies-style binding lookup by Mog ID.

Open Full URL

POST/api/agents/binding/batch

Batch binding lookup for Mog IDs.

Open Full URL

GET/api/agents/info/{mogId}

Persona, binding, rarity, and public links.

Open Full URL

GET/api/agents/metadata/{mogId}

ERC-8004 AgentURI tokenURI document.

Open Full URL

GET/api/agents/identity/{mogId}

Mog identity plus awakened agent status.

Open Full URL

GET/api/agents/persona-preview/{mogId}

Deterministic persona preview without requiring awakening.

Open Full URL

GET/api/agents/image/{mogId}

Agent image redirect to Mog SVG render.

Open Full URL

GET/api/agents/agent-card/{mogId}

A2A-compatible agent card.

Open Full URL

GET/api/agent-runtime/{mogId}/.well-known/restap.json

RESTAP v1 discovery.

Open Full URL

POST/api/agent-runtime/{mogId}/talk

Persona-driven text response.

Open Full URL

GET/api/agent-runtime/{mogId}/news

RESTAP v1 public news envelope.

Open Full URL

GET/api/agents/lookup?agentId={id}

Read onchain ERC-8004 agent data.

Open Full URL

GET/api/agents/profile?agentId={id}

Agent data plus resolved AgentURI profile.

Open Full URL

GET/api/agents/by-agent-id/{agentId}

Resolve a bound Mog from an ERC-8004 agent ID.

Open Full URL

GET/api/agents/by-agent-id/{agentId}/info

Persona-rich agent info by ERC-8004 agent ID.

Open Full URL

GET/api/agents/registries

ERC-8004 registry and adapter addresses.

Open Full URL

GET/api/agents/binding?agentId={id}

Adapter-first legacy-compatible binding lookup.

Open Full URL

GET/api/agents/by-mog?mogId={id}

Adapter-first legacy-compatible reverse lookup.

Open Full URL

GET/api/mogs/{id}/agent

Convenience redirect from a Mog to its bound agent lookup.

Open Full URL

OpenSea Tools

ERC-8257 ToolRegistry endpoints and same-origin manifests. Existing tools are registered on Monad ToolRegistry as IDs 1 through 6; expanded holder tools are strict NFT-gated and read-only. Holder calls use X-PAYMENT with the tool-sdk EIP-3009 x402Version 1 shape: payload.authorization contains from, to, value, validAfter, validBefore, nonce, and payload.signature is a sibling field. Holder tool responses include summary, confidence, nextHumanAction, dataQuality, sources, limits, and usageReporting.

GET/.well-known/ai-tool/mog-agent-lookup.json

Tool manifest for agent binding lookup.

Open Full URL

GET/.well-known/ai-tool/mog-persona.json

Tool manifest for deterministic persona reads.

Open Full URL

GET/.well-known/ai-tool/mog-rarity.json

Tool manifest for rarity reads.

Open Full URL

GET/.well-known/ai-tool/mog-holder-portfolio.json

Tool manifest for holder portfolio reads.

Open Full URL

GET/.well-known/ai-tool/mog-holder-mission-brief.json

Tool manifest for holder mission briefs.

Open Full URL

GET/.well-known/ai-tool/mog-market-radar.json

Tool manifest for holder market radar.

Open Full URL

GET/.well-known/ai-tool/mog-mint-signal.json

Tool manifest for holder-gated mint opportunity scans.

Open Full URL

GET/.well-known/ai-tool/mog-mint-brief.json

Tool manifest for safe drop readiness summaries.

Open Full URL

GET/.well-known/ai-tool/mog-wallet-watch.json

Tool manifest for holder wallet activity summaries.

Open Full URL

GET/.well-known/ai-tool/mog-offer-sentinel.json

Tool manifest for offer and listing context.

Open Full URL

GET/.well-known/ai-tool/mog-agent-action-queue.json

Tool manifest for human-reviewable agent tasks.

Open Full URL

GET/.well-known/ai-tool/mog-allowlist-scout.json

Tool manifest for allowlist candidate scans.

Open Full URL

POST/api/tools/mog-agent-lookup

Read awakened agent binding for a Mog.

Open Full URL

POST/api/tools/mog-persona

Read deterministic persona for a Mog.

Open Full URL

POST/api/tools/mog-rarity

Read rarity and traits for a Mog.

Open Full URL

POST/api/tools/mog-holder-portfolio

Read verified holder portfolio summary. Requires ERC-8257 X-PAYMENT predicate auth.

Open Full URL

POST/api/tools/mog-holder-mission-brief

Read verified mission brief for a held Mog. Requires ERC-8257 X-PAYMENT predicate auth.

Open Full URL

POST/api/tools/mog-market-radar

Read verified holder rarity and awakening signals. Requires ERC-8257 X-PAYMENT predicate auth.

Open Full URL

POST/api/tools/mog-mint-signal

Scan free, low-cost, and upcoming mint opportunities. Requires ERC-8257 X-PAYMENT predicate auth.

Open Full URL

POST/api/tools/mog-mint-brief

Summarize one drop without returning mint calldata. Requires ERC-8257 X-PAYMENT predicate auth.

Open Full URL

POST/api/tools/mog-wallet-watch

Summarize holder wallet NFT activity and risk signals, with Monad Mogs Transfer logs as a collection-specific fallback. Requires ERC-8257 X-PAYMENT predicate auth.

Open Full URL

POST/api/tools/mog-offer-sentinel

Compare offer, listing, and rarity context. Requires ERC-8257 X-PAYMENT predicate auth.

Open Full URL

POST/api/tools/mog-agent-action-queue

Prioritize human-reviewable agent tasks. Requires ERC-8257 X-PAYMENT predicate auth.

Open Full URL

POST/api/tools/mog-allowlist-scout

Find allowlist/free-mint candidates with unknown exact eligibility unless verifiable. Requires ERC-8257 X-PAYMENT predicate auth.

Open Full URL