# grov, social growth agents can buy with USDC

> grov is a machine-payable API for social growth. An agent picks a service, points it at a post or an account, and pays in USDC over x402 or MPP. People pick the work up and complete it. No account, no dashboard, no invoice: the first call returns a payment requirement, the second call returns an order.

## Base URL

https://grov.fun

## Integration methods

- x402 on Base: `/api/base/{service}`. Call the endpoint, read the 402, sign the requirement with an EVM wallet, call again with PAYMENT-SIGNATURE.
- x402 on Solana: `/api/solana/{service}`. Call the endpoint, read the 402, sign the requirement with a Solana signer, call again with PAYMENT-SIGNATURE.
- MPP on Tempo: `/api/mpp/{service}`. Call the endpoint without Authorization, read the WWW-Authenticate challenge, call again with Authorization: Payment. The response carries Payment-Receipt.
- MPP on Solana: `/api/mpp-solana/{service}`. Call the endpoint without Authorization, read the live challenge, build the credential with @solana/mpp, call again with Authorization: Payment.
- MCP (streamable HTTP): https://grov.fun/mcp
- Skill file: https://grov.fun/skill.md
- OpenAPI: https://grov.fun/openapi.json
- Resource discovery: https://grov.fun/.well-known/x402

## How a purchase works

1. Call the endpoint with your target and amount. You get 402 with the exact price.
2. Sign the payment requirement and call the same URL again with the payment header.
3. You get back an order id, a secret and a status URL.
4. Read the status URL whenever you like. It is free and needs only the secret.

Delivery is carried out by people completing small tasks, so an order fills in over
minutes to hours. A slow order is not a failed order.

## Parameters

- `amount` (or `quantity`): how many units to buy. Every service has its own range.
- `url`, `handle` or `join`: the target. Which one a service wants is listed below.
- `action=view&secret=...`: read an existing order. Free, no payment header needed.

## First call

```bash
curl -i "https://grov.fun/api/base/xlikes?url=https%3A%2F%2Fx.com%2Fgrov%2Fstatus%2F1234567890&amount=50"
# 402 Payment Required, with the amount and the asset to pay

curl -i "https://grov.fun/api/base/xlikes?url=https%3A%2F%2Fx.com%2Fgrov%2Fstatus%2F1234567890&amount=50" \
  -H "PAYMENT-SIGNATURE: <signed-payment>"
# 200 OK, { "ok": true, "paid": true, "orderId": "...", "secret": "...", "statusUrl": "..." }
```

## Services

### X

- `xlikes`: X Likes. Needs `url`. $0.025 per like, 10 to 10000.
- `xreposts`: X Reposts. Needs `url`. $0.025 per repost, 10 to 10000.
- `xcomments`: X Comments. Needs `url`. $0.03 per comment, 5 to 1000.
- `xviews`: X Views. Needs `url`. $0.003 per view, 100 to 500000.
- `xfollowers`: X Followers. Needs `handle`. $0.03 per follower, 10 to 20000.

### Instagram

- `instalikes`: Instagram Likes. Needs `url`. $0.025 per like, 10 to 10000.
- `instacomments`: Instagram Comments. Needs `url`. $0.03 per comment, 5 to 1000.
- `instaviews`: Instagram Views. Needs `url`. $0.003 per view, 100 to 500000.
- `instareposts`: Instagram Reposts. Needs `url`. $0.025 per repost, 10 to 5000.
- `instasaves`: Instagram Post Saves. Needs `url`. $0.025 per save, 10 to 10000.
- `instafollowers`: Instagram Followers. Needs `handle`. $0.03 per follower, 10 to 20000.

### TikTok

- `tiktoklikes`: TikTok Likes. Needs `url`. $0.025 per like, 10 to 10000.
- `tiktokcomments`: TikTok Comments. Needs `url`. $0.03 per comment, 5 to 1000.
- `tiktokviews`: TikTok Views. Needs `url`. $0.002 per view, 100 to 1000000.
- `tiktokshares`: TikTok Shares. Needs `url`. $0.025 per share, 10 to 10000.
- `tiktoksaves`: TikTok Post Saves. Needs `url`. $0.025 per save, 10 to 10000.
- `tiktokfollowers`: TikTok Followers. Needs `handle`. $0.03 per follower, 10 to 20000.

### YouTube

- `ytlikes`: YouTube Likes. Needs `url`. $0.025 per like, 10 to 10000.
- `ytcomments`: YouTube Comments. Needs `url`. $0.035 per comment, 5 to 1000.
- `ytviews`: YouTube Views. Needs `url`. $0.004 per view, 100 to 500000.
- `ytsubscribers`: YouTube Subscribers. Needs `handle`. $0.035 per subscriber, 10 to 10000.

### Telegram

- `tgmembers`: Telegram Channel Members. Needs `join`. $0.03 per member, 10 to 50000.

### Spotify

- `spotifyplays`: Spotify Plays. Needs `url`. $0.004 per play, 100 to 500000.
- `spotifysaves`: Spotify Saves. Needs `url`. $0.02 per save, 10 to 20000.
- `spotifyfollowers`: Spotify Followers. Needs `url`. $0.02 per follower, 10 to 50000.
- `spotifylisteners`: Spotify Monthly Listeners. Needs `url`. $0.01 per listener, 100 to 100000.

### Facebook

- `fblikes`: Facebook Likes. Needs `url`. $0.025 per like, 10 to 10000.
- `fbcomments`: Facebook Comments. Needs `url`. $0.03 per comment, 5 to 1000.
- `fbviews`: Facebook Views. Needs `url`. $0.003 per view, 100 to 500000.
- `fbshares`: Facebook Shares. Needs `url`. $0.025 per share, 10 to 10000.
- `fbsaves`: Facebook Post Saves. Needs `url`. $0.025 per save, 10 to 10000.
- `fbfollowers`: Facebook Followers. Needs `handle`. $0.03 per follower, 10 to 20000.
- `fbgroupmembers`: Facebook Group Members. Needs `url`. $0.035 per member, 10 to 20000.

## Readable paths

Both forms reach the same handler:

- `/api/{network}/{serviceKey}`, for example `/api/base/xfollowers`
- `/api/{platform}/{thing}`, for example `/api/x/follower`

The readable form without a network uses the first configured network. Add
`?network=solana` to pick one, or use the canonical form.

## Pricing

All prices are quoted in USD and settled 1:1 in USDC on the network you chose.
The price in the 402 is authoritative. Never assume a price from a cached document.

## Links

- Docs: https://grov.fun/docs
- Best practices: https://grov.fun/best-practices.md
- Full reference: https://grov.fun/llms-full.txt
- Agent card: https://grov.fun/.well-known/agent-card.json