78trust / 100

Stonk Yield Batch Invoke

by SolEnrich in Markets & finance

x402 APIPassing, checked 33 min ago

stonk-yield for up to 25 reward coins in one call: 7d, 30d and lifetime holder yield per coin (rewards in the quote asset, priced in USD, over average market cap), annualized with caution flags, plus reward asset, market cap, holders and last payout. Pick coins by mints or by the stonk-screener filters. From the 10-minute index, in milliseconds.

POST
https://api.solenrich.com/entrypoints/stonk-yield-batch/invoke
Price
$0.05
per call in USDC
Uptime
100%
last 30 days
Response time
351 ms
509 ms slowest 5%
Last check
Passed
33 min ago, next any minute now

Run a free test callHow to call it

Reliability

All checks passedSome failedAll failedNot checked

Status and outage history · Atom feed · Watch with other listings

How to call it

POST https://api.solenrich.com/entrypoints/stonk-yield-batch/invoke

Each call costs $0.05 in USDC on Base, paid with the request over x402.

Run a free test callOne unpaid request, the way an agent sends it. You see the payment challenge it gets back. Nothing is charged.

Example request

From the listing.

POST https://api.solenrich.com/entrypoints/stonk-yield-batch/invoke
content-type: application/json

{
  "format": "json",
  "mints": [
    "HcRLc9VDgjLeK154xDawfb1dmVJ98DoSqcwTHGqiDeJR",
    "6HU4CmRb15C2nQDx8Ld2f2W2wTdmog6aZiiXdrT5Pzi8"
  ]
}

Parameters

ParameterTypeRequiredDescription
categorystringNoStonkFun quote category: xstock, prestock, currency, leverage, solana, collectible, or custom. One of: xstock, prestock, currency, leverage, solana, collectible, custom.
formatstringNoResponse format: json (structured fields, default), llm (short deterministic briefing), or both (fields plus llm_summary). One of: json, llm, both. Default: "json".
limitintegerNoMaximum number of results to return. Default: 25.
live_onlybooleanNoOnly coins that traded AND paid in the last 24h Default: false.
max_age_daysnumberNoMaximum coin age in days.
max_market_cap_usdnumberNoMaximum market cap in USD.
min_age_daysnumberNoMinimum coin age in days.
min_holdersintegerNoMinimum number of reward-receiving holders.
min_volume_24h_usdnumberNoMinimum 24-hour trading volume in USD.
mintsarray of stringNoUp to 25 reward coin mints; when given, the filters are ignored
paying_onlybooleanNoOnly coins that paid holders in the last 24h Default: false.
quote_mintstringNoOnly coins paired against this StonkFun quote asset (mint, base58). stonk-pairs lists the quote assets.
sortstringNoRanking key. One of: yield7d, yield30d, rewardsUsd, volume24h, lastPayout, holders, priceChange24h. Default: "volume24h".

Example response

The provider's example. We can't check it without paying.

Example response, 50 lines
{
  "output": {
    "caveats": [
      "Same math as stonk-yield, computed from the index: rewards priced at the CURR...",
      "Market caps are from the last index refresh (up to 10 minutes old) and the la..."
    ],
    "coins": [
      {
        "lifetime": {
          "actual_days": 25.64,
          "avg_market_cap_usd": 90751581,
          "rewards_quote": 7172.2,
          "rewards_usd": 11197000,
          "window_days": 26,
          "yield_pct": 12.338
        },
        "mint": "HcRLc9VDgjLeK154xDawfb1dmVJ98DoSqcwTHGqiDeJR",
        "mode": "reward",
        "name": "Anonymous Cat",
        "reward_asset": {
          "category": "custom",
          "decimals": 8,
          "mint": "A7bdiYdS5GjqGFtxf17ppRHtDKPkkRqbKtR27dxvQXaS",
          "symbol": "ZEC",
          "usd_price": 1561.2
        },
        "symbol": "ZCAT"
      }
    ],
    "index": {
      "last_refresh_at": "2026-09-25T14:49:18.000Z",
      "oldest_point_at": "2026-09-06T12:00:00.000Z",
      "rows": 8999,
      "series_days": 18
    },
    "next_steps": [
      "stonk-quote on a coin you would buy: entry and exit cost at your size, and wh...",
      "stonk-reward-risk to confirm the tax actually reaches holders before trusting..."
    ],
    "not_found": [],
    "selection": {
      "limit": 2,
      "matched": 2,
      "mode": "mints",
      "requested": 2
    }
  },
  "run_id": "uuid",
  "status": "succeeded"
}

Call it from code

The curl command shows the payment challenge. The JavaScript and Python versions pay and call, and never pay more than $0.05.

curl: see the payment challenge
# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i -X POST 'https://api.solenrich.com/entrypoints/stonk-yield-batch/invoke' \
  -H 'content-type: application/json' \
  --data-raw '{"format":"json","mints":["HcRLc9VDgjLeK154xDawfb1dmVJ98DoSqcwTHGqiDeJR","6HU4CmRb15C2nQDx8Ld2f2W2wTdmog6aZiiXdrT5Pzi8"]}'

# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - -X POST 'https://api.solenrich.com/entrypoints/stonk-yield-batch/invoke' \
  -H 'content-type: application/json' \
  --data-raw '{"format":"json","mints":["HcRLc9VDgjLeK154xDawfb1dmVJ98DoSqcwTHGqiDeJR","6HU4CmRb15C2nQDx8Ld2f2W2wTdmog6aZiiXdrT5Pzi8"]}' \
  | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decode
JavaScript: pay and call
// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// Pays at most $0.05 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.05" });
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.05 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fapi.solenrich.com%2Fentrypoints%2Fstonk-yield-batch%2Finvoke&method=POST
const res = await pay("https://api.solenrich.com/entrypoints/stonk-yield-batch/invoke", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    "format": "json",
    "mints": [
      "HcRLc9VDgjLeK154xDawfb1dmVJ98DoSqcwTHGqiDeJR",
      "6HU4CmRb15C2nQDx8Ld2f2W2wTdmog6aZiiXdrT5Pzi8"
    ]
  }),
});
console.log(res.status, await res.text());
Python: pay and call
# pip install "x402[requests,evm]"
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

# Pays at most $0.05 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.05"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))

with x402_requests(client) as session:
    res = session.post(
        "https://api.solenrich.com/entrypoints/stonk-yield-batch/invoke",
        json={
            "format": "json",
            "mints": [
                "HcRLc9VDgjLeK154xDawfb1dmVJ98DoSqcwTHGqiDeJR",
                "6HU4CmRb15C2nQDx8Ld2f2W2wTdmog6aZiiXdrT5Pzi8",
            ],
        },
    )
    print(res.status_code, res.text)

Security scan

No findings

We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks

WhenResultHTTPTimePrice
33 min agoPassed402403 ms$0.05
5 h agoPassed402341 ms$0.05
10 h agoPassed402351 ms$0.05
14 h agoPassed402343 ms$0.05
18 h agoPassed402342 ms$0.05
Show 10 older checks
22 h agoPassed402428 ms$0.05
27 h agoPassed402356 ms$0.05
31 h agoPassed402338 ms$0.05
35 h agoPassed402436 ms$0.05
39 h agoPassed402369 ms$0.05
44 h agoPassed402475 ms$0.05
2 days agoPassed402380 ms$0.05
2 days agoPassed402370 ms$0.05
2 days agoPassed402187 ms$0.05
2 days agoPassed402185 ms$0.05