API Reference

⚠️

The SentiDex REST API is in early access. Endpoints and response shapes may change before mainnet.

Base URL

https://api.sentidex.io/v1

Authentication

Public read endpoints require no authentication. Write endpoints (future) will require an API key.

Markets

`GET /markets`

Returns all active SentiDex markets.

[
  {
    "marketId": "25",
    "name": "What is Crypto For?",
    "ticker": "CRYPTO",
    "isExpanding": true,
    "positionCount": 12,
    "reserveBps": 2000
  }
]

`GET /markets/:id`

Returns full market detail including all positions and current prices.

Parameters

Param	Type	Description
`id`	`string`	On-chain market ID

Response

{
  "marketId": "25",
  "name": "What is Crypto For?",
  "positions": [
    {
      "positionId": "1",
      "ticker": "MONY",
      "name": "Crypto as Money",
      "price": 0.1415,
      "shares": "14230000000000000000000"
    },
    {
      "positionId": "2",
      "ticker": "DEFI",
      "name": "Crypto as DeFi",
      "price": 0.1413,
      "shares": "14150000000000000000000"
    }
  ],
  "reservePrice": 0.20,
  "updatedAt": "2026-06-06T09:00:00Z"
}

Attention Index

`GET /index/current`

Returns the current SentiDex attention score for each tracked category.

{
  "timestamp": "2026-06-06T09:00:00Z",
  "scores": {
    "MONY": 0.182,
    "DEFI": 0.154,
    "AI":   0.211,
    "STBL": 0.089,
    "GAME": 0.076,
    "INFR": 0.098,
    "PRIV": 0.042,
    "MEME": 0.061,
    "TOKN": 0.047,
    "SOVR": 0.040
  }
}

`GET /index/history`

Returns historical attention scores.

Query parameters

Param	Default	Description
`from`	7 days ago	ISO 8601 start date
`to`	now	ISO 8601 end date
`resolution`	`1h`	`5m`, `1h`, `1d`
`tickers`	all	Comma-separated list e.g. `MONY,AI`

Response

{
  "resolution": "1h",
  "series": [
    {
      "timestamp": "2026-06-05T00:00:00Z",
      "scores": { "MONY": 0.178, "AI": 0.204 }
    }
  ]
}

Prices

`GET /markets/:id/prices`

Returns the current implied price (attention share) for each position in a market.

{
  "marketId": "25",
  "prices": {
    "MONY": 0.1415,
    "STBL": 0.0848,
    "DEFI": 0.1413,
    "AI":   0.0707,
    "GAME": 0.0283,
    "INFR": 0.0707,
    "PRIV": 0.0212,
    "MEME": 0.0070,
    "TOKN": 0.1060,
    "SOVR": 0.0569,
    "PMK":  0.0600,
    "SDEX": 0.0400,
    "reserve": 0.2000
  },
  "updatedAt": "2026-06-06T09:00:00Z"
}

WebSocket

`wss://api.sentidex.io/v1/stream`

Real-time stream of price updates and attention score changes.

Subscribe message

{ "type": "subscribe", "channel": "prices", "marketId": "25" }

Event

{
  "type": "price_update",
  "marketId": "25",
  "positionId": "1",
  "ticker": "MONY",
  "price": 0.1430,
  "timestamp": "2026-06-06T09:01:23Z"
}

Overview