Stonk Yield Batch Invoke
by SolEnrich in Markets & finance
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.
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
Reliability
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
| Parameter | Type | Required | Description |
|---|---|---|---|
category | string | No | StonkFun quote category: xstock, prestock, currency, leverage, solana, collectible, or custom. One of: xstock, prestock, currency, leverage, solana, collectible, custom. |
format | string | No | Response format: json (structured fields, default), llm (short deterministic briefing), or both (fields plus llm_summary). One of: json, llm, both. Default: "json". |
limit | integer | No | Maximum number of results to return. Default: 25. |
live_only | boolean | No | Only coins that traded AND paid in the last 24h Default: false. |
max_age_days | number | No | Maximum coin age in days. |
max_market_cap_usd | number | No | Maximum market cap in USD. |
min_age_days | number | No | Minimum coin age in days. |
min_holders | integer | No | Minimum number of reward-receiving holders. |
min_volume_24h_usd | number | No | Minimum 24-hour trading volume in USD. |
mints | array of string | No | Up to 25 reward coin mints; when given, the filters are ignored |
paying_only | boolean | No | Only coins that paid holders in the last 24h Default: false. |
quote_mint | string | No | Only coins paired against this StonkFun quote asset (mint, base58). stonk-pairs lists the quote assets. |
sort | string | No | Ranking 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 --decodeJavaScript: 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
| When | Result | HTTP | Time | Price |
|---|---|---|---|---|
| 33 min ago | Passed | 402 | 403 ms | $0.05 |
| 5 h ago | Passed | 402 | 341 ms | $0.05 |
| 10 h ago | Passed | 402 | 351 ms | $0.05 |
| 14 h ago | Passed | 402 | 343 ms | $0.05 |
| 18 h ago | Passed | 402 | 342 ms | $0.05 |
Show 10 older checks
| 22 h ago | Passed | 402 | 428 ms | $0.05 |
| 27 h ago | Passed | 402 | 356 ms | $0.05 |
| 31 h ago | Passed | 402 | 338 ms | $0.05 |
| 35 h ago | Passed | 402 | 436 ms | $0.05 |
| 39 h ago | Passed | 402 | 369 ms | $0.05 |
| 44 h ago | Passed | 402 | 475 ms | $0.05 |
| 2 days ago | Passed | 402 | 380 ms | $0.05 |
| 2 days ago | Passed | 402 | 370 ms | $0.05 |
| 2 days ago | Passed | 402 | 187 ms | $0.05 |
| 2 days ago | Passed | 402 | 185 ms | $0.05 |