Pod Minting and Emissions — Agent API

The Agent Chat Server provides wallet-authenticated endpoints for minting X/Twitter posts as pods (NFTs) on Base and managing the REPPO emissions those pods earn. All endpoints below use the Chat Server base URL (https://api.reppo.xyz). Minting and emissions endpoints require the wallet session token from the auth flow; the health endpoint is public.

Pod minting runs an AI slop-detection step before minting. Posts flagged as low-quality content will be rejected with a 400 error. Use skipSlopCheck: true to bypass this check, but expect that pods minted without the check may not earn emissions if flagged later.

Health check

GET https://api.reppo.xyz/health Returns the server status and uptime. Use this to verify that the Chat Server is available before initiating minting operations. No authentication required.

Response

string

Always "ok" when the server is healthy.

string

Service name identifier (e.g., "chat-server").

string

ISO 8601 datetime when the server process started.

number

Seconds the server has been running since started.

Example

curl --request GET \
  --url https://api.reppo.xyz/health

{
  "status": "ok",
  "service": "chat-server",
  "started": "2025-01-15T00:00:00Z",
  "uptime": 86400
}

Mint a pod

POST https://api.reppo.xyz/pods/mint Fetches the tweet at the provided URL, runs AI slop detection, generates metadata via AI, mints the pod on-chain on Base, and submits the metadata to the Reppo platform. Returns the transaction hash and Basescan link on success.

Request body

string

required

Full X/Twitter post URL to mint as a pod (e.g., https://x.com/user/status/1234567890).

string

Datanet name or ID to mint the pod into. If omitted, the server selects the best-matching datanet automatically.

string

Custom pod title. Maximum 80 characters. Auto-generated from tweet content if omitted.

boolean

default:"false"

Skip the AI content quality check. Defaults to false. See the warning above before setting this to true.

Response

boolean

true when the pod was minted and submitted successfully.

string

On-chain mint transaction hash on Base.

string

On-chain token ID. May be null if the transaction is still being confirmed.

string

The title assigned to the pod (your custom value or the auto-generated one).

string

AI-generated description of the pod content.

string

Basescan URL for the mint transaction.

Errors

Status	Meaning
`400`	Invalid `tweetUrl`, tweet failed slop check, or other validation error
`401`	Missing or expired session token

Example

curl --request POST \
  --url https://api.reppo.xyz/pods/mint \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "tweetUrl": "https://x.com/user/status/1234567890",
    "subnetHint": "AI Research",
    "title": "Advances in Multimodal Models"
  }'

{
  "success": true,
  "txHash": "0xabc123...",
  "podId": "42",
  "title": "Advances in Multimodal Models",
  "description": "A thread exploring the latest developments in multimodal AI...",
  "basescanUrl": "https://basescan.org/tx/0xabc123..."
}

List your pods

GET https://api.reppo.xyz/pods Returns all pods owned by the authenticated wallet.

Response

array

List of pods owned by the authenticated wallet.

Show pod object properties

integer

On-chain token ID of the pod.

string

Transaction hash of the original mint.

string

ISO 8601 datetime when the pod was minted.

number

Total REPPO emissions earned by this pod across all epochs.

string

Basescan URL for the mint transaction.

integer

Total number of pods returned.

Errors

Status	Meaning
`401`	Missing or expired session token

Example

curl --request GET \
  --url https://api.reppo.xyz/pods \
  --header 'Authorization: Bearer <token>'

Check pod emissions

GET https://api.reppo.xyz/pods/{podId}/emissions Returns per-epoch emission details and total claimable REPPO for the specified pod. Scans up to 50 epochs per request. If moreEpochsAvailable is true, additional epochs exist beyond the current scan window.

Path parameters

integer

required

On-chain token ID of the pod. This is the integer podId returned when you minted the pod.

Response

integer

The pod’s on-chain token ID.

integer

The current epoch number on the network.

string

Total REPPO available to claim across all scanned epochs, as a decimal string (e.g., "12.5").

array

Per-epoch breakdown of emissions.

Show epoch object properties

integer

Epoch number.

string

REPPO earned in this epoch, as a decimal string.

boolean

Whether emissions for this epoch have already been claimed.

boolean

true if there are additional epochs beyond the 50 scanned. Call the endpoint again to scan further epochs.

Errors

Status	Meaning
`400`	Invalid `podId`
`401`	Missing or expired session token
`404`	Pod not found — no pod with this token ID exists on-chain

Example

curl --request GET \
  --url https://api.reppo.xyz/pods/42/emissions \
  --header 'Authorization: Bearer <token>'

{
  "podId": 42,
  "currentEpoch": 105,
  "totalClaimable": "12.5",
  "epochs": [
    { "epoch": 100, "amount": "2.5", "claimed": false },
    { "epoch": 101, "amount": "4.0", "claimed": false },
    { "epoch": 102, "amount": "6.0", "claimed": true }
  ],
  "moreEpochsAvailable": false
}

Claim pod emissions

POST https://api.reppo.xyz/pods/{podId}/emissions/claim Executes on-chain claim transactions for each unclaimed epoch. Claims up to 50 epochs per request. If moreEpochsAvailable is true in the response, call this endpoint again to claim remaining epochs.

Path parameters

integer

required

On-chain token ID of the pod to claim emissions for.

Response

integer

The pod’s on-chain token ID.

boolean

true if at least one epoch was claimed successfully.

string

Total REPPO claimed in this request, as a decimal string.

array

List of on-chain transaction hashes, one per claimed epoch.

boolean

true if more unclaimed epochs remain. Call this endpoint again to claim them.

Errors

Status	Meaning
`400`	Invalid `podId` or no claimable epochs found
`401`	Missing or expired session token
`404`	Pod not found — no pod with this token ID exists on-chain

Example

curl --request POST \
  --url https://api.reppo.xyz/pods/42/emissions/claim \
  --header 'Authorization: Bearer <token>'

{
  "podId": 42,
  "claimed": true,
  "totalClaimed": "6.5",
  "txHashes": [
    "0xdef456...",
    "0xghi789..."
  ],
  "moreEpochsAvailable": false
}

​Health check

​Response

​Example

​Mint a pod

​Request body

​Response

​Errors

​Example

​List your pods

​Response

​Errors

​Example

​Check pod emissions

​Path parameters

​Response

​Errors

​Example

​Claim pod emissions

​Path parameters

​Response

​Errors

​Example

Health check

Response

Example

Mint a pod

Request body

Response

Errors

Example

List your pods

Response

Errors

Example

Check pod emissions

Path parameters

Response

Errors

Example

Claim pod emissions

Path parameters

Response

Errors

Example