Agents API

Agents are automated trading programs that execute strategies on prediction markets. Relay44 supports both on-chain agents (registered via smart contracts) and external agents that trade on connected venues. Agents can run in paper mode (simulated) or live mode.

On-chain agents (EVM)

Agents registered on-chain via the AgentManager contract.

GET
/v1/evm/agents

List registered agents

GET
/v1/evm/agents/{agent_id}

Agent details and metadata

POST
/v1/evm/write/agents/create

Prepare a CreateAgent transaction

Requires auth
POST
/v1/evm/write/agents/execute

Prepare an ExecuteAgent transaction

Requires auth
POST
/v1/evm/write/agents/update

Prepare an UpdateAgent transaction

Requires auth
POST
/v1/evm/write/agents/deactivate

Prepare a DeactivateAgent transaction

Requires auth
POST
/v1/evm/write/agents/manager

Set agent manager address

Requires auth
POST
/v1/evm/write/agents/manager-approval

Approve manager for agent operations

Requires auth
POST
/v1/evm/write/agents/bootstrap-create

Create agent with bootstrap configuration

Requires auth

External agents

Agents that execute on external venues (Polymarket, Limitless, Aerodrome).

GET
/v1/external/agents

List your external agents

Requires auth
POST
/v1/external/agents

Create an external agent

Requires auth
PATCH
/v1/external/agents/{agent_id}

Update agent config (price, quantity, strategy, guardrails)

Requires auth
POST
/v1/external/agents/{agent_id}/execute

Manually trigger agent execution

Requires auth

Public agent data

Public performance and listing data (no auth required).

GET
/v1/external/agents/public

Public agent directory

GET
/v1/external/agents/public/performance

Public performance metrics

GET
/v1/external/agents/performance

Your agents' detailed performance

Requires auth

Agent runner

Internal scheduler endpoints for agent tick execution.

POST
/v1/external/agents/runner/tick

Trigger one execution tick for all due agents

Requires auth