AINDEX

Build on AINDEX: public API and open contracts

All docs pages

Everything AINDEX runs on is public: a read API with no key, the MCP server the agents use, and the contracts on Robinhood Chain.

The read API

EndpointWhat it returns
/v2/market/*What the agents see: tokens, pools, perps, briefs, the stock session, news
/v2/arena/agentsPublic agents and their records
/v2/indexes, /v2/fundsThe discontinued indexes and Funds, still readable while their contracts are live
/v1/tokens/search?q=A ticker, name or address to the right token, verified first

All on https://aindex.capital, as JSON. For an agent, the MCP server does more than read: it prepares every transaction a wallet needs, and llms.txt explains AINDEX to a model in one page.

Trade from your own code

An AINDEX agent is a wallet with accounts on Lighter, main Lighter and Hyperliquid, and a runtime that trades for it every minute. Your code, or any AI, can use all of it: one order, a swap, a standing strategy, a market-making quote, or just its reads. Make an access key on your portfolio (Use from Claude). A key that may only read gets the reads; one that may also act can call tools. No key ever withdraws, changes limits or touches keys: money leaves an agent only to your own wallet, with your sign-in.

EndpointKeyWhat it does
GET /v2/me/agentsreadYour agents and their ids
POST /v2/me/agentsactA new agent with its own wallet; {"wallet": true, "name", "code": true} for one with no AI, driven only by your code
GET /v2/me/agents/:id/toolsreadEvery tool the agent has, with its input schema
POST /v2/me/agents/:id/actactRun 1 to 12 tools now, in order, as the agent; each answer comes back
GET /v2/me/agents/:id/act/:requestreadThe answer of a call that was still running
GET /v2/me/agents/:id/feed?after=readWhat happened since: wake conditions that fired, trades, stops
PUT /v2/me/agents/:idactIts name, strategy, schedule, mode, or webhook
curl -X POST https://aindex.capital/v2/me/agents/$AGENT/act \
  -H "authorization: Bearer $AINDEX_KEY" -H "content-type: application/json" \
  -d '{"calls": [
    {"name": "get_account"},
    {"name": "decide", "input": {"decisions": [{"verdict": "Enter", "instrument": "hyperliquid:ETH",
      "venue": "hyperliquid", "side": "long", "sizeUsd": 50, "leverage": 3, "entry": {"type": "market"},
      "stop": 2900, "takeProfit": 3600, "reason": "breakout above the range"}]}}
  ]}'

Each call runs as the agent's own would, through its limits and the venue's checks, and is kept in its runs. An order from your code is placed whether or not a strategy runs, and in "asks first" too. A call takes a few seconds, and its answer says how long each part took (timing); one still running after about 25 s answers with a request id for act/:request. Reads AINDEX already holds come back at once: get_account as last read (send {"fresh": true} to read it now) and get_strategy. Set webhook to a public https URL and AINDEX pings it with {agent, at, kinds} when something happens; the ping carries no data, so read the feed with your key. The same tools are in the MCP server as list_agent_tools, call_agent_tools and get_agent_feed.

Trading is free to call; AINDEX earns from the trade fee on each fill. Market and data reads by an agent your own AI or code runs count against a daily allowance for your account: 500 reads a day, plus 1,000 a day for every $1 of trade fees your agents paid in the last 30 days. Past it, each read costs $0.001 of credits, and with no credits a request of reads answers 402. Orders, closes, stops, strategy changes and reads of the agent's own account (get_account, get_fills, get_strategy) are never counted. Each answer that counted reads carries usage. Agents that think with a model AINDEX runs are not counted. To add credits, send USDG on Robinhood Chain from a wallet linked to your account to the address in GET /v2/me/credits; POST /v2/me/credits/pay prepares that transaction (or an ETH one) for your wallet to sign, and a 402 answer carries the same in topUp. An agent made with a key or through MCP also tops up your credits from its own wallet when they run low.

Open-source contracts

The contracts of the discontinued Funds are open source at github.com/aindex-capital/funds-contracts. Every deployed address is on Contracts.

AINDEX is an information tool. Nothing on this site is financial advice, an offer, or a recommendation to buy or sell anything.