# Synapse API — Citrea Token Metadata

> Synapse API — Citrea Token Metadata is a paid API for AI agents from synapse-api-brown.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-16).

Fetches on-chain token metadata (name, symbol, decimals, etc.) for a given contract address on the Citrea blockchain network.

## Facts

- Endpoint: POST https://synapse-api-brown.vercel.app/api/citrea/token/metadata?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/synapse-api-citrea-token-metadata-28575cb3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rRYHi74ERjAl4v_t4qWqj

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 synapse-api-citrea-token-metadata-28575cb3 -d '<json body>'
```

Example prompt: Can you look up the token metadata — name, symbol, and decimals — for the Citrea contract at 0x1234567890abcdef1234567890abcdef12345678?

## When to prefer this

Use this endpoint when you specifically need token metadata (name, symbol, decimals) for a contract deployed on the Citrea blockchain. It is purpose-built for Citrea and avoids the overhead of multi-chain aggregators. Choose this over generic blockchain explorers when you need a lightweight, pay-per-call programmatic lookup within an automated agent workflow.

## Known failure modes

- Invalid or malformed contract address returns an error or empty response
- Contract address does not exist on Citrea — returns not found or null metadata
- Contract is not a standard token contract (e.g. no ERC-20 interface) — metadata fields may be missing
- Network congestion or RPC issues may cause timeouts
- Payment failure via x402 protocol prevents the call from completing

## How this service works

High-speed API suite for AI processing, web scraping, and smart data utilities across 57+ blockchain networks. Pay-per-call via x402.

## Output

Returns on-chain token metadata for the specified Citrea contract address, including fields such as token name, symbol, and decimal precision. Useful for identifying and enriching token information in DeFi applications, wallets, or analytics dashboards.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "contractAddress": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/synapse-api-citrea-token-metadata-28575cb3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from synapse-api-brown.vercel.app](https://www.zero.xyz/host/synapse-api-brown.vercel.app/llms.txt)