Semantic Listener

This endpoint allows subscribers to listen for data that matches specific criteria defined semantically (using natural language queries) across various indexes. It supports complex queries, including filtering and sorting, to fine-tune the data stream received.

Listening to Index Updates

The Index Client SDK allows you to listen for updates to multiple indexes in real-time. This is useful for applications that need to react to new data events, using natural language.

Here is an example of how you can use the listenToIndexUpdates method to handle real-time updates in a conversation:

const sources = ["did:pkh:eip155:1:0x1b9Aceb609a62bae0c0a9682A9268138Faff4F5f"];

const query = "if it is relevant to decentralized AI";

const handleMessage = (data: any) => {
  console.log("New event received:", data);
  // Handle the new message data
};

const handleError = (error: any) => {
  console.error("Error receiving updates:", error);
  // Handle the error
};

const stopListening = indexClient.listenToIndexUpdates(
  sources,
  query
  handleMessage,
  handleError,
);

Endpoints

This section provides details about the available API endpoints.

Listen Index updates

GEThttps://dev.index.network/api/discovery/updates

Query parameters

Response

200400500

Updates are streamed as server-sent events.

Body

text/event-stream

string

Example: "event: message\ndata: {\"id\":\"1\",\"message\":\"Update received\"}\n"

Request

JavaScriptCurlPython

const response = await fetch('https://dev.index.network/api/discovery/updates?sources=text&query=text&session=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

event: message
data: {"id":"1","message":"Update received"}