# Tokenguard Mastodon Social Posts

> Tokenguard Mastodon Social Posts is a paid API for AI agents from eltociear-tokenguard.hf.space, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Fetches recent Mastodon posts from a given instance, returning post content, author, and engagement data

## Facts

- Endpoint: POST https://eltociear-tokenguard.hf.space/social/mastodon
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tokenguard-mastodon-social-posts-02ee4723
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aPhRTBKgZF4d6IwIcIdiU

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 tokenguard-mastodon-social-posts-02ee4723 -d '<json body>'
```

Example prompt: Pull recent Mastodon posts from fosstodon.org so I can see what the crypto community is discussing right now.

## When to prefer this

Use this endpoint when you need to monitor or retrieve social sentiment and discussions from the Mastodon/fediverse ecosystem, particularly for crypto and DeFi communities. Prefer this over Twitter/X scrapers when targeting decentralized social networks or privacy-focused tech communities like fosstodon.org.

## Known failure modes

- Invalid or unreachable Mastodon instance returns an error
- Instance rate-limiting or federation issues may return empty results
- Malformed instance URL causes a 400-level error
- No recent posts on the instance returns count 0 with empty posts array

## How this service works

Fediverse posts: search any Mastodon instance or read its public timeline, with author, engagement and hashtags

## Output

Returns a JSON object with a count of posts, an array of post objects each containing the author handle (user@host format), post content text, and favourites count, plus the instance name queried.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "1-40 posts (default 20)"
  },
  "query": {
   "type": "string",
   "description": "Search terms; omit for the public timeline"
  },
  "instance": {
   "type": "string",
   "description": "Mastodon host (default fosstodon.org)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 2,
  "posts": [
   {
    "author": "user@host",
    "content": "…",
    "favourites": 5
   }
  ],
  "instance": "fosstodon.org"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tokenguard-mastodon-social-posts-02ee4723/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from eltociear-tokenguard.hf.space](https://www.zero.xyz/host/eltociear-tokenguard.hf.space/llms.txt)
