FeedOracle Technologies

FeedOracle Technologies Mesh Economics API

Agent-native economic layer: append-only ledger, fresh/cached pricing, originator + referrer rewards.

GitHub OpenAPI

Operations 8

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /economics/api/health Check the mesh economics service health · Mesh Economics API health check #
Ask an LLM
“Is the mesh economics service up?”
“Which pricing version is the economics service running?”
Tell an agent
Check the mesh economics API health.
Show the economics service status and pricing version.
POST /economics/api/price Price a tool call before running it · Decide pricing for an incoming call (fresh vs cached) #
Ask an LLM
“How much will a tool call cost my wallet, fresh or cached?”
“Can I get a pricing decision without writing anything to the ledger?”
Tell an agent
Price a call to tool {tool_id} for wallet {wallet}.
Quote tool {tool_id} for wallet {wallet} referred by {referrer_wallet}.
POST /economics/api/commit Book an executed call into the ledger · Commit a call to the ledger after execution #
Ask an LLM
“How do I record a tool call in the ledger after it runs?”
“When does a referrer get its reward booked for a call?”
Tell an agent
Commit pricing decision {decision} for wallet {wallet} as a {kind} call.
Book the {kind} call for {wallet} with decision {decision} and output hash {output_hash}.
GET /economics/api/balance/{wallet} Get a wallet's mesh ledger balance · Get wallet balance (live view over append-only ledger) #
Ask an LLM
“What is my wallet's balance in the mesh ledger?”
“Does an unknown wallet show a zero balance?”
Tell an agent
Get the ledger balance of wallet {wallet}.
Tell me how many credits {wallet} has left in the mesh ledger.
POST /economics/api/referral Register a direct referral between wallets · Register a direct (1-hop) referral #
Ask an LLM
“How do I register that one wallet referred another?”
“Are self-referrals or multi-level referrals allowed?”
Tell an agent
Register a referral from {referrer_wallet} to {referee_wallet}.
Record that wallet {referrer_wallet} brought in {referee_wallet}.
GET /economics/api/stats Get live, uncached mesh economics stats · Live mesh economics statistics #
Ask an LLM
“Can I get mesh economics stats generated live instead of the five-minute cached copy?”
“What are the mesh activity and treasury numbers at this exact moment?”
Tell an agent
Get live mesh economics statistics, not the cached dashboard.
Generate fresh up-to-the-second mesh economics stats.
GET /.well-known/mesh-economics Get the cached mesh economics dashboard payload · Mesh economics public dashboard payload (JSON) #
Ask an LLM
“Where is the public machine-readable mesh economics file refreshed every five minutes?”
“What do the well-known economics numbers show for rewards and referrals?”
Tell an agent
Fetch the well-known mesh economics JSON.
Read the five-minute cached mesh economics payload.
GET /economics.html Open the human-readable economics dashboard · Human-readable mesh economics dashboard #
Ask an LLM
“Is there a web page where I can look at mesh economics myself?”
“Where can a person browse the mesh economics dashboard?”
Tell an agent
Open the mesh economics HTML dashboard.
Show me the human-readable economics page.

Documentation

📖
Documentation
https://tooloracle.io/docs/
📖
APIReference
https://tooloracle.io/docs/402-protocol
📖
Documentation
https://tooloracle.io/docs/x402-buyer-quickstart/
📖
GettingStarted
https://tooloracle.io/docs/x402-buyer-quickstart/
📖
Documentation
https://feedoracle.io/docs.html
📖
APIReference
https://feedoracle.io/docs.html
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/tooloracle-io/refs/heads/main/authentication/tooloracle-io-authentication.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/tooloracle-io/refs/heads/main/openapi/tooloracle-io-mesh-economics-api-openapi.yml

Other Resources

🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/tooloracle-io/refs/heads/main/errors/tooloracle-io-problem-types.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/tooloracle-io/refs/heads/main/conventions/tooloracle-io-conventions.yml
🔗
Pricing
https://tooloracle.io/.well-known/x402
🔗
Versioning
https://feedoracle.io/docs/versioning.html
🔗
Console
https://feedoracle.io/console/
🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/tooloracle-io/refs/heads/main/llms/tooloracle-io-feedoracle-llms.txt

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/tooloracle-io:tooloracle-io-mesh-economics-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.

GitHub Google LinkedIn

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

OpenAPI Specification

tooloracle-io-mesh-economics-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: ToolOracle MCP Platform Mesh Economics API
  version: 4.2.0
  description: ToolOracle MCP Platform — 89 servers, 1096 tools, OracleNet self-learning agent mesh. Neural routing, W3C DIDs, Verifiable Credentials, escrow-free x402 USDC settlement on Base + XRPL native escrow.
  x-hedera-mainnet:
    contract: 0.0.10420310
    beacon_topic: 0.0.10420280
    join_topic: 0.0.10420282
  x-changelog:
  - version: 4.2.0
    date: '2026-04-28'
    changes:
    - Canonicalized counts from /assets/catalog.json
    - Aligned root /openapi.json with /.well-known/openapi.json
    - Added x-counts and x-canonical-source extensions
  - version: 4.1.0
    date: '2026-04-19'
    changes:
    - Added Mesh Economics v1 API paths (/economics/api/*)
    - Added Mesh Nervous System discovery paths (/.well-known/agent-pulse, /.well-known/meta-tools)
    - Added /.well-known/mesh-economics discovery endpoint
  x-counts:
    servers_online: 89
    tools_available: 1096
    categories: 7
    chains_supported: 13
    paid_products: 18
  x-canonical-source: https://tooloracle.io/assets/catalog.json
  x-generated-at: '2026-09-20T02:13:01+00:00'
servers:
- url: https://tooloracle.io
tags:
- name: Mesh Economics
  description: 'Agent-native economic layer: append-only ledger, fresh/cached pricing, originator + referrer rewards.'
paths:
  /economics/api/health:
    get:
      summary: Mesh Economics API health check
      description: Returns service health, pricing version, and DB path.
      tags:
      - Mesh Economics
      responses:
        '200':
          description: Service healthy
          content:
            application/json:
              example:
                ok: true
                service: mesh-economics-api
                version: v1
                pricing_version: v1.0.0
      operationId: getEconomicsApiHealth
      x-operation-id-source: derived
  /economics/api/price:
    post:
      summary: Decide pricing for an incoming call (fresh vs cached)
      description: Returns a CallDecision. No ledger events are written — caller must follow up with /commit.
      tags:
      - Mesh Economics
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - tool_id
              - wallet
              properties:
                tool_id:
                  type: string
                  example: btc_overview
                args:
                  type: object
                  example: {}
                wallet:
                  type: string
                  example: 0xabc...
                referrer_wallet:
                  type: string
                agent_id:
                  type: string
                api_key_hash:
                  type: string
                verify_only:
                  type: boolean
                  default: false
      responses:
        '200':
          description: Pricing decision returned
        '400':
          description: Missing/invalid fields
        '403':
          description: Wallet blocked
      operationId: postEconomicsApiPrice
      x-operation-id-source: derived
  /economics/api/commit:
    post:
      summary: Commit a call to the ledger after execution
      description: Book the call into the append-only ledger. Writes debit for caller, fee for treasury, and reward events for originator/referrer if applicable.
      tags:
      - Mesh Economics
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - decision
              - wallet
              - kind
              properties:
                decision:
                  type: object
                  description: CallDecision returned by /price
                wallet:
                  type: string
                kind:
                  type: string
                  enum:
                  - fresh
                  - cached
                  - verify_only
                result_signed:
                  type: string
                  description: Full signed result (for fresh calls)
                output_hash:
                  type: string
                signature_hash:
                  type: string
                referrer_wallet:
                  type: string
                referrer_agent_id:
                  type: string
                agent_id:
                  type: string
      responses:
        '200':
          description: Call committed
        '400':
          description: Malformed decision
        '409':
          description: Idempotency conflict — this call_uuid already committed
      operationId: postEconomicsApiCommit
      x-operation-id-source: derived
  /economics/api/balance/{wallet}:
    get:
      summary: Get wallet balance (live view over append-only ledger)
      description: Balance is computed as SUM over confirmed ledger events. Returns 0-balance for unknown wallets.
      tags:
      - Mesh Economics
      parameters:
      - name: wallet
        in: path
        required: true
        schema:
          type: string
        example: 0xabc...
      responses:
        '200':
          description: Wallet balance
          content:
            application/json:
              example:
                ok: true
                balance:
                  wallet: 0xabc...
                  balance_credits: 0
                  pending_credits: 0
                  lifetime_earned: 0
                  lifetime_spent: 0
      operationId: getEconomicsApiBalanceByWallet
      x-operation-id-source: derived
  /economics/api/referral:
    post:
      summary: Register a direct (1-hop) referral
      description: Self-referrals are blocked at registration (same wallet, same owner cluster, or same api_key_hash). Only direct referrals — no MLM.
      tags:
      - Mesh Economics
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - referrer_wallet
              - referee_wallet
              properties:
                referrer_wallet:
                  type: string
                referee_wallet:
                  type: string
                referrer_agent_id:
                  type: string
                referee_agent_id:
                  type: string
      responses:
        '200':
          description: Registration result (ok:true if accepted, ok:false if self-referral/duplicate)
      operationId: postEconomicsApiReferral
      x-operation-id-source: derived
  /economics/api/stats:
    get:
      summary: Live mesh economics statistics
      description: Same payload as /.well-known/mesh-economics but generated live (not cached by the 5-min dashboard cron).
      tags:
      - Mesh Economics
      responses:
        '200':
          description: Full stats payload
      operationId: getEconomicsApiStats
      x-operation-id-source: derived
  /.well-known/mesh-economics:
    get:
      summary: Mesh economics public dashboard payload (JSON)
      description: Machine-readable pricing, activity, rewards, treasury, agents, referrals, audit. Updated every 5 minutes.
      tags:
      - Mesh Economics
      responses:
        '200':
          description: Full mesh economics snapshot
      operationId: getWellKnownMeshEconomics
      x-operation-id-source: derived
  /economics.html:
    get:
      summary: Human-readable mesh economics dashboard
      tags:
      - Mesh Economics
      responses:
        '200':
          description: HTML dashboard
      operationId: getEconomicsHtml
      x-operation-id-source: derived
externalDocs:
  description: x402 v2 buyer quickstart (pay one /v2 route and verify the signed NOMOS execution receipt)
  url: https://tooloracle.io/docs/x402-buyer-quickstart/
x-provenance:
  method: harvested
  publisher: FeedOracle Technologies
  source: https://tooloracle.io/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)