datakoot-com Economy Intel API

The Economy Intel API from datakoot-com — 5 operation(s) for economy intel.

Operations 5

POST /api/country_indicator Country Indicator (Economy Intel) #
POST /api/country_profile Country Profile (Economy Intel) #
POST /api/compare_countries Compare Countries (Economy Intel) #
POST /api/us_series US Series (Economy Intel) #
POST /api/list_indicators List Indicators (Economy Intel) #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/datakoot-com:datakoot-com-economy-intel-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

datakoot-com-economy-intel-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Datakoot x402 data Economy Intel API
  version: 2.8.0
  x-guidance: 'Call POST /api/<tool> with a JSON body of the tool''s arguments (GET with a query string also works). Without payment you get HTTP 402 with an x402 v2 challenge (PAYMENT-REQUIRED header and JSON body): pay $0.01 USDC on Base (eip155:8453) to the listed payTo using the exact scheme, then retry with the PAYMENT-SIGNATURE header. Datakoot verifies the payment, runs the tool, and settles only if the tool succeeds; a tool error returns 422 with charged:false. Successful responses are plain JSON matching each operation''s 200 schema, with the on-chain receipt in PAYMENT-RESPONSE. Start with cve_lookup, package_health, financials, country_profile or domain_report. MCP clients can use /mcp; every tool is also free for 100 calls/day at <server>.datakoot.com/mcp.'
  description: 48 live public-data tools (security, packages, SEC filings, economy, FX, weather, domains, Federal Register, Base) plus 4 Koot briefing tools that combine many lookups into one answer, for AI agents. $0.01 USDC per call (every tool and every Koot brief) on Base via x402, charged only on success. The same tools are free for 100 calls/day via MCP at .datakoot.com/mcp.
  contact:
    email: hello@datakoot.com
    url: https://datakoot.com
servers:
- url: https://x402.datakoot.com
tags:
- name: Economy Intel
paths:
  /api/country_indicator:
    post:
      operationId: country_indicator
      summary: Country Indicator (Economy Intel)
      description: 'Get a macroeconomic indicator for a country over recent years (World Bank). Indicators: gdp, gdp_per_capita, gdp_growth, inflation, unemployment, population, life_expectancy, exports, imports, govt_debt_pct_gdp, real_interest_rate, fdi, co2_per_capita, internet_users. Country accepts an ISO code (US, DE, JP) or a World Bank country code. You may also pass a raw World Bank indicator code. PAID: $0.01 USDC per call via x402 (charged only on success).'
      tags:
      - Economy Intel
      x-payment-info:
        price:
          currency: USD
          mode: fixed
          amount: '0.01'
        protocols:
        - x402:
            scheme: exact
            network: eip155:8453
            asset: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913'
            payTo: '0x3de7b2de531053340cf132d29b837e5a0e924177'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                country:
                  type: string
                  description: Country as an ISO code or name, e.g. JP, JPN, or Japan.
                indicator:
                  type: string
                  description: 'World Bank indicator key: gdp, gdp_per_capita, gdp_growth, inflation, population, unemployment, life_expectancy, exports, imports, govt_debt_pct_gdp, real_interest_rate, fdi, co2_per_capita, internet_users. Call list_indicators for the full set. Raw World Bank codes are also accepted.'
                years:
                  type: integer
                  default: 12
                  description: How many of the most recent years to return.
              required:
              - country
              - indicator
            example:
              country: DE
              indicator: inflation
              years: 5
      responses:
        '200':
          description: Tool result (charged)
          content:
            application/json:
              schema:
                type: object
                properties:
                  country: {}
                  indicator: {}
                  code: {}
                  series: {}
                  source: {}
                additionalProperties: true
        '402':
          description: 'Payment required: x402 challenge in the PAYMENT-REQUIRED header and body'
        '422':
          description: Tool error (not charged)
  /api/country_profile:
    post:
      operationId: country_profile
      summary: Country Profile (Economy Intel)
      description: 'Get a snapshot of a country''s key macro indicators (latest available values): GDP, GDP per capita, GDP growth, inflation, unemployment, and population. Country accepts an ISO code. PAID: $0.01 USDC per call via x402 (charged only on success).'
      tags:
      - Economy Intel
      x-payment-info:
        price:
          currency: USD
          mode: fixed
          amount: '0.01'
        protocols:
        - x402:
            scheme: exact
            network: eip155:8453
            asset: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913'
            payTo: '0x3de7b2de531053340cf132d29b837e5a0e924177'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                country:
                  type: string
                  description: Country as an ISO code or name, e.g. DE, DEU, or Germany.
              required:
              - country
            example:
              country: JP
      responses:
        '200':
          description: Tool result (charged)
          content:
            application/json:
              schema:
                type: object
                properties:
                  country: {}
                  latest: {}
                  source: {}
                additionalProperties: true
        '402':
          description: 'Payment required: x402 challenge in the PAYMENT-REQUIRED header and body'
        '422':
          description: Tool error (not charged)
  /api/compare_countries:
    post:
      operationId: compare_countries
      summary: Compare Countries (Economy Intel)
      description: 'Compare one indicator across several countries (latest available value each). Good for ranking or benchmarking economies. PAID: $0.01 USDC per call via x402 (charged only on success).'
      tags:
      - Economy Intel
      x-payment-info:
        price:
          currency: USD
          mode: fixed
          amount: '0.01'
        protocols:
        - x402:
            scheme: exact
            network: eip155:8453
            asset: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913'
            payTo: '0x3de7b2de531053340cf132d29b837e5a0e924177'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                countries:
                  type: array
                  items:
                    type: string
                  description: Array of country codes or names to compare, e.g. ["US", "DE", "JP"].
                indicator:
                  type: string
                  description: 'World Bank indicator key: gdp, gdp_per_capita, gdp_growth, inflation, population, unemployment, life_expectancy, exports, imports, govt_debt_pct_gdp, real_interest_rate, fdi, co2_per_capita, internet_users. Call list_indicators for the full set. Raw World Bank codes are also accepted.'
              required:
              - countries
              - indicator
            example:
              countries:
              - US
              - CN
              - IN
              indicator: gdp
      responses:
        '200':
          description: Tool result (charged)
          content:
            application/json:
              schema:
                type: object
                properties:
                  indicator: {}
                  code: {}
                  ranking: {}
                  source: {}
                additionalProperties: true
        '402':
          description: 'Payment required: x402 challenge in the PAYMENT-REQUIRED header and body'
        '422':
          description: Tool error (not charged)
  /api/us_series:
    post:
      operationId: us_series
      summary: US Series (Economy Intel)
      description: 'Get a key US economic time series. From the Bureau of Labor Statistics: us_unemployment_rate, us_cpi, us_nonfarm_payrolls, us_labor_participation, us_avg_hourly_earnings, us_ppi. From the US Census Bureau: us_retail_sales (advance retail & food services, seasonally adjusted). The BLS series are kept warm by Datakoot and always available. A raw BLS series ID is also accepted, but BLS rate-limits by client IP and Datakoot runs on shared edge IPs, so an uncached series may return an upstream-limit error instead of data; that error means the upstream refused, not that the series does not exist. PAID: $0.01 USDC per call via x402 (charged only on success).'
      tags:
      - Economy Intel
      x-payment-info:
        price:
          currency: USD
          mode: fixed
          amount: '0.01'
        protocols:
        - x402:
            scheme: exact
            network: eip155:8453
            asset: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913'
            payTo: '0x3de7b2de531053340cf132d29b837e5a0e924177'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                series:
                  type: string
                  description: 'A US series key: us_unemployment_rate, us_cpi, us_nonfarm_payrolls, us_labor_participation, us_avg_hourly_earnings, us_ppi (BLS), or us_retail_sales (US Census). These are cached by Datakoot and kept current. A raw BLS series ID is also accepted, but uncached series often hit BLS rate limits.'
              required:
              - series
            example:
              series: unemployment
      responses:
        '200':
          description: Tool result (charged)
          content:
            application/json:
              schema:
                type: object
                properties:
                  series: {}
                  seriesID: {}
                  data: {}
                  as_of: {}
                  source: {}
                additionalProperties: true
        '402':
          description: 'Payment required: x402 challenge in the PAYMENT-REQUIRED header and body'
        '422':
          description: Tool error (not charged)
  /api/list_indicators:
    post:
      operationId: list_indicators
      summary: List Indicators (Economy Intel)
      description: 'List the indicators this server supports (World Bank + US BLS), with descriptions. Call this to discover what you can query. PAID: $0.01 USDC per call via x402 (charged only on success).'
      tags:
      - Economy Intel
      x-payment-info:
        price:
          currency: USD
          mode: fixed
          amount: '0.01'
        protocols:
        - x402:
            scheme: exact
            network: eip155:8453
            asset: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913'
            payTo: '0x3de7b2de531053340cf132d29b837e5a0e924177'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties: {}
            example: {}
      responses:
        '200':
          description: Tool result (charged)
          content:
            application/json:
              schema:
                type: object
                properties:
                  world_bank: {}
                  us_bls: {}
                  us_census: {}
                  note: {}
                additionalProperties: true
        '402':
          description: 'Payment required: x402 challenge in the PAYMENT-REQUIRED header and body'
        '422':
          description: Tool error (not charged)