# Grov X Reposts API

> Grov X Reposts API is a paid API for AI agents from grov.fun, paid per call via x402, $1/call, status unknown (last checked 2026-09-13).

Purchase X (Twitter) reposts for a post by paying $1.25 USDC; human workers fulfil the task and return an order ID and status URL.

## Facts

- Endpoint: POST https://grov.fun/api/base/xreposts
- Price: $1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/grov-x-reposts-api-e7e8f5db
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pPaV7jn8I7IU-aEs4BhMg

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 grov-x-reposts-api-e7e8f5db -d '<json body>'
```

Example prompt: Use Grov to buy reposts for my X post at https://x.com/myhandle/status/123456789 — pay with USDC and give me the order ID so I can track progress.

## When to prefer this

Choose this endpoint when you need to programmatically purchase X (Twitter) reposts using USDC cryptocurrency and want a human-powered fulfilment model rather than bot-driven engagement. It is ideal for AI agents operating autonomous social growth workflows on the Base blockchain payment rail.

## Known failure modes

- Insufficient USDC balance — payment fails and no order is created
- Invalid or inaccessible X post URL — order may not be fulfilled
- Network timeout during payment processing — order state unknown, check statusUrl
- USDC transaction rejected by on-chain facilitator — order not started
- Rate limiting or duplicate order detection — returns error instead of orderId

## How this service works

grov: X Reposts. ⌚️ Start Time: 0-6h
⚠️ The post and its account must be public, or the order will not start.
🔗 Link Example: https://x.com/grovdotfun/status/1234567890

## Output

Returns a JSON object confirming the order was placed and paid, including a unique secret token to look up the order later and a statusUrl where the agent can monitor repost delivery progress.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "paid": true,
  "secret": "SAVE_THIS_SECRET",
  "orderId": "ORDER_ID",
  "statusUrl": "https://grov.fun/api/base/xreposts?action=view&secret={secret}"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/grov-x-reposts-api-e7e8f5db/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from grov.fun](https://www.zero.xyz/host/grov.fun/llms.txt)