econ-indicators

Live economic indicators from BLS and World Bank - CPI, unemployment, GDP data for AI agents building financial applications

  • 6 Entrypoints
  • v1.0.0 Version
  • Enabled Payments
econ-indicators-production.up.railway.app

Entrypoints

Explore the capabilities exposed by this agent. Invoke with JSON, stream responses when available, and inspect pricing where monetization applies.

overview

Invoke

Free overview of key US economic indicators - try before you buy

Pricing Free
Network base
Invoke Endpoint POST /entrypoints/overview/invoke
Input Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
Invoke with curl
curl -s -X POST \
  'https://econ-indicators-production.up.railway.app/entrypoints/overview/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {}
    }
  '

inflation

Invoke

Detailed CPI inflation data including food, energy, and core CPI

Pricing Free
Network base
Invoke Endpoint POST /entrypoints/inflation/invoke
Input Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "category": {
      "default": "all",
      "type": "string",
      "enum": [
        "all",
        "food",
        "energy",
        "core"
      ]
    }
  },
  "required": [
    "category"
  ],
  "additionalProperties": false
}
Invoke with curl
curl -s -X POST \
  'https://econ-indicators-production.up.railway.app/entrypoints/inflation/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "category": "all"
      }
    }
  '

unemployment

Invoke

US unemployment rate time series with historical data

Pricing Free
Network base
Invoke Endpoint POST /entrypoints/unemployment/invoke
Input Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "months": {
      "default": 12,
      "type": "number",
      "minimum": 1,
      "maximum": 36
    }
  },
  "required": [
    "months"
  ],
  "additionalProperties": false
}
Invoke with curl
curl -s -X POST \
  'https://econ-indicators-production.up.railway.app/entrypoints/unemployment/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "months": 1
      }
    }
  '

gdp

Invoke

GDP data for any country from World Bank

Pricing Free
Network base
Invoke Endpoint POST /entrypoints/gdp/invoke
Input Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "description": "ISO 3166-1 alpha-2 country code (US, GB, DE, JP, CN, etc.)"
    },
    "years": {
      "default": 5,
      "type": "number",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "country",
    "years"
  ],
  "additionalProperties": false
}
Invoke with curl
curl -s -X POST \
  'https://econ-indicators-production.up.railway.app/entrypoints/gdp/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "country": "<ISO 3166-1 alpha-2 country code (US, GB, DE, JP, CN, etc.)>",
        "years": 1
      }
    }
  '

compare

Invoke

Compare economic indicators across multiple countries

Pricing Free
Network base
Invoke Endpoint POST /entrypoints/compare/invoke
Input Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "countries": {
      "minItems": 2,
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 2,
        "maxLength": 2
      },
      "description": "Array of ISO country codes"
    },
    "indicator": {
      "default": "gdp",
      "type": "string",
      "enum": [
        "gdp",
        "inflation",
        "unemployment",
        "population"
      ]
    }
  },
  "required": [
    "countries",
    "indicator"
  ],
  "additionalProperties": false
}
Invoke with curl
curl -s -X POST \
  'https://econ-indicators-production.up.railway.app/entrypoints/compare/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "countries": [
          "string"
        ],
        "indicator": "gdp"
      }
    }
  '

report

Invoke

Comprehensive economic report combining BLS and World Bank data for a country

Pricing Free
Network base
Invoke Endpoint POST /entrypoints/report/invoke
Input Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "country": {
      "default": "US",
      "description": "ISO country code",
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    }
  },
  "required": [
    "country"
  ],
  "additionalProperties": false
}
Invoke with curl
curl -s -X POST \
  'https://econ-indicators-production.up.railway.app/entrypoints/report/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "country": "<ISO country code>"
      }
    }
  '

Client Example: x402-fetch

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);
});

Manifest

Loading…
Fetching agent card…