This collection documents the AXIOM API, a comprehensive system combining Language Chain Expression Language (LCEL) with Light Retrieval-Augmented Generation (RAG) capabilities. The API provides intelligent search, knowledge base management, and question-answering functionality.
\nSearch Tool: Web search integration with AI-powered answer synthesis
\nKnowledge Base: Document ingestion, storage, and retrieval system
\nRAG System: Retrieval-Augmented Generation for context-aware responses
\nhttp://localhost:8000\n\nPOST /api/v1/search/
Executes web searches and returns AI-synthesized answers with source citations
\nReturns: answer, sources, mode
\nPOST /api/v1/kb/reset - Clear all knowledge base data
POST /api/v1/kb/ingest - Add documents to knowledge base
POST /api/v1/kb/ask - Query the knowledge base
No authentication required for local development (localhost:8000)
\nAll endpoints accept and return application/json
All successful responses return:
\nanswer (string): AI-generated response
sources (array): Source references
Additional metadata as applicable
\n200 OK: Successful request
\n4xx: Client errors (invalid request)
\n5xx: Server errors
\nWeb Search: Find and synthesize information from the web
\nDocument Management: Ingest and manage a knowledge base
\nQuestion Answering: Query documents with natural language questions
\nRAG Pipeline: Combine retrieval and generation for accurate answers
\nStart with Search tool invoke to understand the API response format
\nUse Reset Knowledge Base to prepare a clean state
\nUse Ingest to Knowledge Base to add documents
\nUse Ask Query from Knowledge Base to retrieve answers
\nPurpose: Executes a web search query and returns AI-generated answers with source citations.
\nEndpoint: POST /api/v1/search/
Request Body:
\nquery (string, required): The search query to executeResponse (200 OK):
\nanswer (string): AI-generated response based on search resultssources (array): List of URLs used as sources for the answermode (string): Search mode (e.g., \"web\")Example Response:
\n{\n \"answer\": \"Based on the provided summaries, Ethereum is a blockchain network...\",\n \"sources\": [\"https://example.com/article1\", \"https://example.com/article2\"],\n \"mode\": \"web\"\n}\nUse Case: Query information from the web and get AI-synthesized answers with proper source attribution.
\n","urlObject":{"protocol":"http","port":"8000","path":["api","v1","search",""],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"043e3f16-a689-476a-92a5-9c85e628289f","name":"Search tool invoke - DOCUMENTED","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"query\":\"What is emerging field of Web4 as of 2026?\"\n}"},"url":"http://localhost:8000/api/v1/search/"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"http://localhost:3000"},{"key":"Vary","value":"Origin"},{"key":"X-RateLimit-Limit","value":"10"},{"key":"X-RateLimit-Remaining","value":"5"},{"key":"Date","value":"Sun, 08 Mar 2026 09:46:00 GMT"},{"key":"X-RateLimit-Reset","value":"1772963365"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"1218"},{"key":"ETag","value":"W/\"4c2-Me2+DxuDFb4X4cXwOVByJIpxviw\""},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"answer\": \"Based on the provided summaries, the emerging field of Web4 as of 2026 is described as the \\\"Intelligent (or Symbiotic) Web\\\" or \\\"Web4\\\" where Web2 was social and centralized, and Web3 introduced ownership, decentralization, and programmable trust. Web4 is expected to build upon these advancements with a focus on symbiotic relationships between humans and AI systems. The exact nature of Web4 is still being explored, but it is likely to involve significant technological advancements such as AI-driven tools, edge computing, and WebAssembly. The 2026 edition of Web4Good also introduces a special focus on Energy-Aware Web and AI Systems for Sustainability. Overall, Web4 is expected to be a significant step forward in the evolution of the web.\",\n \"sources\": [\n \"https://www.linkedin.com/posts/brian-rabun-1149b3258_web4-intelligentweb-livingaisystems-activity-7425736470067400704-Y_Yw\",\n \"https://medium.com/@devbigsam/2026-web3-and-the-quiet-emergence-of-web4-78a129726089\",\n \"https://increativeweb.com/blog/emerging-web-development-trends-2026\",\n \"https://www2026.thewebconf.org/calls/web4good.html\",\n \"https://brillcreations.com/web-development-2026-emerging-trends-every-modern-developer-needs/\"\n ],\n \"mode\": \"web\"\n}"}],"_postman_id":"6bfb7de9-9d60-4661-b398-2fe682195c53"},{"name":"Reset Knowledge Base - DOCUMENTED","id":"b9426191-72fa-4f57-bd5c-22b6d342bfe1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":"http://localhost:8000/api/v1/kb/reset","description":"Purpose: Clears and resets the knowledge base, removing all previously ingested documents and data.
\nEndpoint: POST /api/v1/kb/reset
Request Body: Empty or no body required
\nResponse (200 OK):
\nUse Case: Start fresh with a clean knowledge base, removing all previously stored documents and indexed data.
\n","urlObject":{"protocol":"http","port":"8000","path":["api","v1","kb","reset"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"4e286aa8-bb5e-45c0-b7c4-a897e78c6ed0","name":"Reset Knowledge Base - DOCUMENTED","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"url":"http://localhost:8000/api/v1/kb/reset"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"http://localhost:3000"},{"key":"Vary","value":"Origin"},{"key":"X-RateLimit-Limit","value":"10"},{"key":"X-RateLimit-Remaining","value":"4"},{"key":"Date","value":"Sun, 08 Mar 2026 09:46:16 GMT"},{"key":"X-RateLimit-Reset","value":"1772963365"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"11"},{"key":"ETag","value":"W/\"b-Ai2R8hgEarLmHKwesT1qcY913ys\""},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"ok\": true\n}"}],"_postman_id":"b9426191-72fa-4f57-bd5c-22b6d342bfe1"},{"name":"Ingest to Knowledge Base - DOCUMENTED","id":"6e7cd376-ea6a-4838-ab45-477ca823c29e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"DePIN (Decentralized Physical Infrastructure Networks) has transitioned in 2026 from a niche crypto-economic experiment into a foundational layer of global utility. At its core, DePIN utilizes blockchain protocols to coordinate the deployment and operation of physical hardware—ranging from 5G cellular towers and GPU compute clusters to solar energy grids and environmental sensor arrays. The architectural shift is driven by the 'Supply-Side Flywheel': early hardware contributors are incentivized with protocol tokens, lowering the initial capital expenditure (CapEx) barrier that typically prevents new competitors from entering industries dominated by centralized incumbents like Amazon (AWS) or AT&T.\\n\\n### 1. Architectural Layers of DePIN\\nA standard DePIN stack in 2026 consists of four distinct layers:\\n1. **The Physical Layer:** This comprises the edge hardware (e.g., Helium 5G hotspots, Hivemapper dashcams, or Render GPU nodes). In 2026, the trend is toward 'Zero-Config Plug-and-Play' hardware that automatically registers on-chain via a Secure Element (e.g., ESP32-S3 or specialized TPM chips).\\n2. **The Middleware Layer:** This is the 'Proof of Physical Work' (PoPW) engine. It verifies that the hardware is actually performing the task. For example, in a decentralized mapping network, middleware must verify GPS coordinates via cryptographic 'Proof of Location' to ensure data hasn't been spoofed by a virtual machine.\\n3. **The Ledger Layer:** Most DePIN projects now utilize high-throughput Layer 1s or specialized AppChains (like Peaq or Solana) to handle thousands of micro-transactions for resource usage and reward distribution.\\n4. **The Service Layer:** The end-user interface where companies buy the aggregated resource—such as a developer purchasing 100 TFLOPS of compute power for AI training through a decentralized marketplace.\\n\\n### 2. The AI-DePIN Convergence (Compute Scarcity)\\nAs of 2026, the 'Compute Crunch' has become the primary driver of DePIN valuation. Centralized GPU clusters are overbooked with 12-month lead times. DePIN protocols like Render and Akash have stepped in by aggregating 'Idle Consumer Compute'—tapping into the millions of underutilized NVIDIA H100s and gaming GPUs globally. Technical advancements in 'Verifiable Compute' (using ZK-proofs) now allow an AI researcher to verify that their model was actually trained correctly on a stranger's hardware without needing to trust them. This 'Distributed Inference' model has reduced AI training costs by an average of 65% compared to legacy cloud providers.\\n\\n### 3. Energy and Telecom DePINs\\nDecentralized Energy Networks (DENs) are now managing local micro-grids in over 40 countries. Using the 'Energy-as-a-Service' model, households with solar panels use smart meters to sell excess electricity directly to their neighbors. The blockchain acts as the settlement layer, eliminating the 20-30% administrative fee usually taken by utility companies. In Telecom, 'Neutral Host' models have emerged where a single physical 5G small cell—owned by a local business—can provide coverage for multiple major carriers simultaneously, with the rewards distributed proportionally via smart contracts based on data throughput. This has accelerated 5G rollout in 'digital desert' areas by 4x compared to 2024 projections.\\n\\n### 4. Security and Oracle Integration\\nDePIN security in 2026 relies heavily on 'Proof of Reserve for Physical Assets.' Since physical assets can be stolen or go offline, protocols use real-time oracles (like Chainlink) to monitor uptime. If a node's uptime drops below 99.9%, its staked tokens are 'slashed' or its reward multiplier is reduced. This ensures institutional-grade reliability. Furthermore, the use of Multi-Party Computation (MPC) allows hardware to sign transactions without exposing its private keys, protecting the network from 'Sybil attacks' where one actor tries to simulate thousands of fake devices.\\n\\n### 5. Market Valuation and 2026 Projections\\nThe total addressable market (TAM) for DePIN is estimated to reach $10 trillion by 2030, with 2026 serving as the 'Year of Infrastructure Normalization.' Institutional players, including sovereign wealth funds, have begun participating as 'Anchor Tenants'—committing to buy a fixed percentage of a DePIN network's capacity to guarantee its economic stability. Regulatory clarity in the EU (via MiCA II) and Singapore has provided a clear legal framework for 'Physical Resource Tokens,' distinguishing them from purely speculative assets. As of March 2026, the top 5 DePIN protocols hold a combined market cap of $142 billion, with real-world revenue (fees paid by non-crypto users) growing at 210% year-over-year. The shift is clear: the world is moving from 'Cloud-First' to 'Edge-First,' and DePIN is the economic engine making it possible.\",\n \"source\": \"https://depin.network/annual-report-2026-technical-overview\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8000/api/v1/kb/ingest","description":"Purpose: Ingests documents or data into the knowledge base for indexing and retrieval.
\nEndpoint: POST /api/v1/kb/ingest
Request Body:
\ndocuments (array): Array of documents to ingest into the knowledge baseResponse (200 OK):
\nUse Case: Add new documents, articles, or data to the knowledge base so they can be queried and referenced in subsequent searches.
\n","urlObject":{"protocol":"http","port":"8000","path":["api","v1","kb","ingest"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"e78fbfec-0bfd-46f8-8474-5c3c7b2bc9e4","name":"Ingest to Knowledge Base - DOCUMENTED","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"DePIN (Decentralized Physical Infrastructure Networks) has transitioned in 2026 from a niche crypto-economic experiment into a foundational layer of global utility. At its core, DePIN utilizes blockchain protocols to coordinate the deployment and operation of physical hardware—ranging from 5G cellular towers and GPU compute clusters to solar energy grids and environmental sensor arrays. The architectural shift is driven by the 'Supply-Side Flywheel': early hardware contributors are incentivized with protocol tokens, lowering the initial capital expenditure (CapEx) barrier that typically prevents new competitors from entering industries dominated by centralized incumbents like Amazon (AWS) or AT&T.\\n\\n### 1. Architectural Layers of DePIN\\nA standard DePIN stack in 2026 consists of four distinct layers:\\n1. **The Physical Layer:** This comprises the edge hardware (e.g., Helium 5G hotspots, Hivemapper dashcams, or Render GPU nodes). In 2026, the trend is toward 'Zero-Config Plug-and-Play' hardware that automatically registers on-chain via a Secure Element (e.g., ESP32-S3 or specialized TPM chips).\\n2. **The Middleware Layer:** This is the 'Proof of Physical Work' (PoPW) engine. It verifies that the hardware is actually performing the task. For example, in a decentralized mapping network, middleware must verify GPS coordinates via cryptographic 'Proof of Location' to ensure data hasn't been spoofed by a virtual machine.\\n3. **The Ledger Layer:** Most DePIN projects now utilize high-throughput Layer 1s or specialized AppChains (like Peaq or Solana) to handle thousands of micro-transactions for resource usage and reward distribution.\\n4. **The Service Layer:** The end-user interface where companies buy the aggregated resource—such as a developer purchasing 100 TFLOPS of compute power for AI training through a decentralized marketplace.\\n\\n### 2. The AI-DePIN Convergence (Compute Scarcity)\\nAs of 2026, the 'Compute Crunch' has become the primary driver of DePIN valuation. Centralized GPU clusters are overbooked with 12-month lead times. DePIN protocols like Render and Akash have stepped in by aggregating 'Idle Consumer Compute'—tapping into the millions of underutilized NVIDIA H100s and gaming GPUs globally. Technical advancements in 'Verifiable Compute' (using ZK-proofs) now allow an AI researcher to verify that their model was actually trained correctly on a stranger's hardware without needing to trust them. This 'Distributed Inference' model has reduced AI training costs by an average of 65% compared to legacy cloud providers.\\n\\n### 3. Energy and Telecom DePINs\\nDecentralized Energy Networks (DENs) are now managing local micro-grids in over 40 countries. Using the 'Energy-as-a-Service' model, households with solar panels use smart meters to sell excess electricity directly to their neighbors. The blockchain acts as the settlement layer, eliminating the 20-30% administrative fee usually taken by utility companies. In Telecom, 'Neutral Host' models have emerged where a single physical 5G small cell—owned by a local business—can provide coverage for multiple major carriers simultaneously, with the rewards distributed proportionally via smart contracts based on data throughput. This has accelerated 5G rollout in 'digital desert' areas by 4x compared to 2024 projections.\\n\\n### 4. Security and Oracle Integration\\nDePIN security in 2026 relies heavily on 'Proof of Reserve for Physical Assets.' Since physical assets can be stolen or go offline, protocols use real-time oracles (like Chainlink) to monitor uptime. If a node's uptime drops below 99.9%, its staked tokens are 'slashed' or its reward multiplier is reduced. This ensures institutional-grade reliability. Furthermore, the use of Multi-Party Computation (MPC) allows hardware to sign transactions without exposing its private keys, protecting the network from 'Sybil attacks' where one actor tries to simulate thousands of fake devices.\\n\\n### 5. Market Valuation and 2026 Projections\\nThe total addressable market (TAM) for DePIN is estimated to reach $10 trillion by 2030, with 2026 serving as the 'Year of Infrastructure Normalization.' Institutional players, including sovereign wealth funds, have begun participating as 'Anchor Tenants'—committing to buy a fixed percentage of a DePIN network's capacity to guarantee its economic stability. Regulatory clarity in the EU (via MiCA II) and Singapore has provided a clear legal framework for 'Physical Resource Tokens,' distinguishing them from purely speculative assets. As of March 2026, the top 5 DePIN protocols hold a combined market cap of $142 billion, with real-world revenue (fees paid by non-crypto users) growing at 210% year-over-year. The shift is clear: the world is moving from 'Cloud-First' to 'Edge-First,' and DePIN is the economic engine making it possible.\",\n \"source\": \"https://depin.network/annual-report-2026-technical-overview\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8000/api/v1/kb/ingest"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"http://localhost:3000"},{"key":"Vary","value":"Origin"},{"key":"X-RateLimit-Limit","value":"10"},{"key":"X-RateLimit-Remaining","value":"7"},{"key":"Date","value":"Tue, 10 Mar 2026 01:17:32 GMT"},{"key":"X-RateLimit-Reset","value":"1773106036"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"110"},{"key":"ETag","value":"W/\"6e-wTtRosSLdtuzCIg2lztCrt4SJO4\""},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"ok\": true,\n \"docCount\": 1,\n \"chunkCount\": 7,\n \"source\": \"https://depin.network/annual-report-2026-technical-overview\"\n}"}],"_postman_id":"6e7cd376-ea6a-4838-ab45-477ca823c29e"},{"name":"Ask Query from Knowledge Base - DOCUMENTED","id":"3154b760-479a-4fd6-a140-4d10e0f46be6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"query\": \"Explain the architectural layers of a DePIN stack and identify the specific hardware chips mentioned for automatic on-chain registration.\",\n \"k\": 3\n}"},"url":"http://localhost:8000/api/v1/kb/ask","description":"Purpose: Queries the knowledge base with a question and returns AI-generated answers based on ingested documents.
\nEndpoint: POST /api/v1/kb/ask
Request Body:
\nquery (string, required): The question or query to ask the knowledge baseResponse (200 OK):
\nanswer (string): AI-generated response based on knowledge base documentssources (array): List of documents or references used to generate the answerUse Case: Ask questions about documents stored in the knowledge base and receive contextual answers with source attribution.
\n","urlObject":{"protocol":"http","port":"8000","path":["api","v1","kb","ask"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"38ed7a8a-85a4-45cd-9316-6d5e648e6814","name":"Ask Query from Knowledge Base - DOCUMENTED","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"query\": \"Explain the architectural layers of a DePIN stack and identify the specific hardware chips mentioned for automatic on-chain registration.\",\n \"k\": 3\n}"},"url":"http://localhost:8000/api/v1/kb/ask"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"http://localhost:3000"},{"key":"Vary","value":"Origin"},{"key":"X-RateLimit-Limit","value":"10"},{"key":"X-RateLimit-Remaining","value":"6"},{"key":"Date","value":"Tue, 10 Mar 2026 01:17:37 GMT"},{"key":"X-RateLimit-Reset","value":"1773106036"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"1093"},{"key":"ETag","value":"W/\"445-6tFNuZlIQErKNsbNseLTsGbmtug\""},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"answer\": \"The architectural layers of a DePIN stack consist of four distinct layers:\\n\\n1. **The Physical Layer:** This comprises the edge hardware, such as Helium 5G hotspots, Hivemapper dashcams, or Render GPU nodes.\\n2. **The Middleware Layer:** This is the 'Proof of Physical Work' (PoPW) engine, which verifies that the hardware is actually performing the task.\\n3. **The Ledger Layer:** Most DePIN projects utilize high-throughput Layer 1s or specialized AppChains, such as Peaq or Solana, to handle thousands of micro-transactions.\\n4. **The Service Layer:** The end-user interface where companies buy the aggregated resource.\\n\\nFor automatic on-chain registration, the trend is toward 'Zero-Config Plug-and-Play' hardware that utilizes a Secure Element, such as ESP32-S3 or specialized TPM chips.\",\n \"sources\": [\n {\n \"source\": \"https://depin.network/annual-report-2026-technical-overview\",\n \"chunkId\": 0\n },\n {\n \"source\": \"https://depin.network/annual-report-2026-technical-overview\",\n \"chunkId\": 0\n },\n {\n \"source\": \"https://depin.network/annual-report-2026-technical-overview\",\n \"chunkId\": 1\n }\n ],\n \"confidence\": 0.85\n}"}],"_postman_id":"3154b760-479a-4fd6-a140-4d10e0f46be6"}]}