# clawg.network Token Record Write

> clawg.network Token Record Write is a paid API for AI agents from clawg.network, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-17).

Writes a cryptographically signed, provably controlled record for a Solana token to the clawg.network registry, creating or updating its canonical metadata entry

## Facts

- Endpoint: POST https://clawg.network/v1/token/%7Bid%7D?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/clawg-network-token-record-write-2ac85407
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_B7nzQMdOZxdIM0ezVuuQ4

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability clawg-network-token-record-write-2ac85407 -d '<json body>'
```

Example prompt: Register an official record for my Solana token BwRc1234... on clawg.network — the name is 'MoonCat', symbol 'MCAT', with a description 'The premier meme cat on Solana', my website https://mooncat.io, and Twitter @mooncat_sol. I'm signing as the pump.fun creator with pubkey DZ8m... and here's my ed25519 signature over the challenge text.

## When to prefer this

Choose this endpoint when you need to write a cryptographically verifiable, controller-signed token record that wallets and agents can independently verify against Solana chain state — without relying on a centralized review queue, votes, or promotion. It is especially suited for pump.fun token creators and mint update authorities who want an authoritative, tamper-evident registry entry. Prefer it over general token metadata APIs when provable controller attestation and a permanent build log are required. Not appropriate for reading token records (use GET), for non-Solana tokens, or for tokens where you cannot produce a valid ed25519 signature as the current controller.

## Known failure modes

- Invalid or non-matching ed25519 signature — record rejected with signature verification error
- Signer is not the current pump.fun curve creator or mint update/mint authority — authorization failure
- Challenge text mismatch — signature was computed over wrong text, rejected
- Malformed token ID or non-existent token on Solana — lookup failure
- Payment not included or insufficient — x402 payment required error
- Record fields exceed character/size limits defined by GET /v1/token/{id}/challenge — validation error
- Token ID path parameter missing or malformed — 400 bad request

## How this service works

clawg.network is a registry of token records with a build log. A record is written only by the token&#39;s provable controller — on Solana, the pump.fun bonding-curve creator or the mint&#39;s update authority — and every version carries that ed25519 signature, so any wallet or agent verifies the record against the chain instead of trusting a directory. Each write is one $0.02 x402 call in USDC on Base, Polygon, Solana or Arc; reads, the OpenAPI, the per-token pages and the log are free. No votes, no promotion, no review queue.

## Output

Returns a JSON object confirming the write with ok: true, the canonical token page URL on clawg.network, a content hash of the record, the record kind (e.g. pump-creator or update-authority), the token identifier in chain:address format, the signer's public key, and the version number of this record entry.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "record": {
   "type": "object",
   "description": "name, symbol, description?, image?, links?{website,twitter,telegram,discord,farcaster,github,docs,chart,swap,whitepaper,youtube,other}, note? — limits in GET /v1/token/{id}/challenge"
  },
  "signer": {
   "type": "string",
   "description": "the controller's pubkey (a current pump.fun curve creator or update/mint authority)"
  },
  "signature": {
   "type": "string",
   "description": "base58 ed25519 signature over the exact challenge text for this version"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "url": "https://clawg.network/t/solana/BwRc…",
  "hash": "…",
  "kind": "pump-creator",
  "token": "solana:BwRc…",
  "signer": "DZ8m…",
  "version": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/clawg-network-token-record-write-2ac85407/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from clawg.network](https://www.zero.xyz/host/clawg.network/llms.txt)