Explore the capabilities exposed by this agent. Invoke with JSON, stream responses when available, and inspect pricing where monetization applies.
Free overview of current social signals - try before you buy
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {},
"additionalProperties": false
}
curl -s -X POST \
'https://social-signals-agent-production.up.railway.app/entrypoints/overview/invoke' \
-H 'Content-Type: application/json' \
-d '
{
"input": {}
}
'
Get top Hacker News stories with scores and comments
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"limit": {
"default": 20,
"type": "number",
"minimum": 1,
"maximum": 50
}
},
"required": [
"limit"
],
"additionalProperties": false
}
curl -s -X POST \
'https://social-signals-agent-production.up.railway.app/entrypoints/hn-top/invoke' \
-H 'Content-Type: application/json' \
-d '
{
"input": {
"limit": 1
}
}
'
Get top news headlines by category
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"category": {
"default": "technology",
"type": "string",
"enum": [
"business",
"entertainment",
"general",
"health",
"science",
"sports",
"technology"
]
},
"limit": {
"default": 15,
"type": "number",
"minimum": 1,
"maximum": 30
}
},
"required": [
"category",
"limit"
],
"additionalProperties": false
}
curl -s -X POST \
'https://social-signals-agent-production.up.railway.app/entrypoints/news/invoke' \
-H 'Content-Type: application/json' \
-d '
{
"input": {
"category": "business",
"limit": 1
}
}
'
Search social signals by topic across HN
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"limit": {
"default": 15,
"type": "number",
"minimum": 1,
"maximum": 30
}
},
"required": [
"query",
"limit"
],
"additionalProperties": false
}
curl -s -X POST \
'https://social-signals-agent-production.up.railway.app/entrypoints/search/invoke' \
-H 'Content-Type: application/json' \
-d '
{
"input": {
"query": "string",
"limit": 1
}
}
'
Get news from multiple categories in one call
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"categories": {
"minItems": 1,
"maxItems": 4,
"type": "array",
"items": {
"type": "string",
"enum": [
"business",
"entertainment",
"general",
"health",
"science",
"sports",
"technology"
]
}
},
"limitPerCategory": {
"default": 5,
"type": "number",
"minimum": 1,
"maximum": 10
}
},
"required": [
"categories",
"limitPerCategory"
],
"additionalProperties": false
}
curl -s -X POST \
'https://social-signals-agent-production.up.railway.app/entrypoints/news-multi/invoke' \
-H 'Content-Type: application/json' \
-d '
{
"input": {
"categories": [
"business"
],
"limitPerCategory": 1
}
}
'
Get aggregated signals from all sources in one call
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"hnLimit": {
"default": 15,
"type": "number",
"minimum": 1,
"maximum": 30
},
"newsCategory": {
"default": "technology",
"type": "string",
"enum": [
"business",
"entertainment",
"general",
"health",
"science",
"sports",
"technology"
]
},
"newsLimit": {
"default": 10,
"type": "number",
"minimum": 1,
"maximum": 20
}
},
"required": [
"hnLimit",
"newsCategory",
"newsLimit"
],
"additionalProperties": false
}
curl -s -X POST \
'https://social-signals-agent-production.up.railway.app/entrypoints/all-signals/invoke' \
-H 'Content-Type: application/json' \
-d '
{
"input": {
"hnLimit": 1,
"newsCategory": "business",
"newsLimit": 1
}
}
'
Use the x402-fetch helpers to wrap a standard
fetch call and automatically attach payments. This
script loads configuration from .env, pays the
facilitator, and logs both the response body and the decoded
payment receipt.
import { config } from "dotenv";
import {
decodeXPaymentResponse,
wrapFetchWithPayment,
createSigner,
type Hex,
} from "x402-fetch";
config();
const privateKey = process.env.AGENT_WALLET_PRIVATE_KEY as Hex | string;
const agentUrl = process.env.AGENT_URL as string; // e.g. https://agent.example.com
const endpointPath = process.env.ENDPOINT_PATH as string; // e.g. /entrypoints/echo/invoke
const url = `${agentUrl}${endpointPath}`;
if (!agentUrl || !privateKey || !endpointPath) {
console.error("Missing required environment variables");
console.error("Required: AGENT_WALLET_PRIVATE_KEY, AGENT_URL, ENDPOINT_PATH");
process.exit(1);
}
/**
* Demonstrates paying for a protected resource using x402-fetch.
*
* Required environment variables:
* - AGENT_WALLET_PRIVATE_KEY Wallet private key for signing payments
* - AGENT_URL Base URL of the agent server
* - ENDPOINT_PATH Endpoint path (e.g. /entrypoints/echo/invoke)
*/
async function main(): Promise<void> {
// const signer = await createSigner("solana-devnet", privateKey); // uncomment for Solana
const signer = await createSigner("base-sepolia", privateKey);
const fetchWithPayment = wrapFetchWithPayment(fetch, signer);
const response = await fetchWithPayment(url, { method: "GET" });
const body = await response.json();
console.log(body);
const paymentResponse = decodeXPaymentResponse(
response.headers.get("x-payment-response")!
);
console.log(paymentResponse);
}
main().catch((error) => {
console.error(error?.response?.data?.error ?? error);
process.exit(1);
});
Fetching agent card…