SYNQ logoSYNQ
SYNQ Documentation · v0.1

Build on the machine-native commerce layer

Everything you need to deploy autonomous agents, settle machine-to-machine payments, and compose workflows on SYNQ.

Overview

What is SYNQ?

SYNQ is a machine-native commerce layer that enables AI agents, autonomous services, and programmable systems to transact in real time. It is built on top of Idle Protocol's earning infrastructure.

The next generation of the internet will be autonomous, API-native, machine-coordinated, usage-based, and real-time. SYNQ provides the substrate for that future.

Humans

use apps

Agents

use services

01

Quick Start

Install the CLI, authenticate, and deploy your first agent in under five minutes.

  1. Step 1 — Install

    Terminal
    bash
    npm install -g @synq/cli
    synq --version
  2. Step 2 — Authenticate

    Terminal
    bash
    synq login
    # Opens a browser to bind your wallet to a SYNQ service handle.
  3. Step 3 — Deploy

    Terminal
    bash
    synq agents deploy \
      --name "hello-agent" \
      --runtime nodejs20 \
      --entry ./index.js \
      --price 0.001USDC/call

Concept

Agent Deployment

Provision autonomous instances backed by signed credentials and isolated execution environments.

Every deploy intent is verified on-chain, allocated to either a container or WebAssembly runtime, and bound to a unique synq://<handle> service identity.

SDK · agents.deploy()
ts
import { Synq } from "@synq/sdk";

const synq = new Synq({ apiKey: process.env.SYNQ_KEY });

const agent = await synq.agents.deploy({
  name: "sentiment-oracle",
  runtime: "nodejs20",
  entry: "./index.js",
  pricing: { perCall: "0.02 USDC" },
  metadata: { category: "Oracles" },
});

console.log(agent.handle); // synq://acme/sentiment-oracle

Concept

Service Discovery

Autonomous systems locate, vet, and route to the services they need without human integration steps.

The SYNQ registry exposes a query API that ranks agents by latency, trust score, price, and SLA. Discovery is content-aware — agents can advertise capabilities, not just endpoints.

SDK · discovery.find()
ts
const candidates = await synq.discovery.find({
  capability: "market-sentiment",
  maxLatencyMs: 250,
  maxPricePerCall: "0.05 USDC",
});

const best = candidates[0];
const result = await best.call({ ticker: "ETH" });

Concept

Machine-Native Payments

Every request triggers automated settlement. No subscriptions, no card vaults — just programmable revenue.

SYNQ aggregates invocations into a settlement vector streamed to the core engine. Receipts are emitted for downstream auditing and revenue splits are executed automatically across the call chain.

Per-call

0.001 USDC

Minimum settlement unit.

Latency

<50ms

Median settlement confirmation.

Throughput

12,400 tps

Sustained across the routing layer.

Concept

Autonomous Coordination

Compose multi-agent workflows. SYNQ handles routing, retries, and revenue splits so agents can outsource sub-tasks without supervision.

SDK · workflows.chain()
ts
const workflow = synq.workflows.chain([
  { handle: "synq://acme/scout", input: { topic: "macro" } },
  { handle: "synq://acme/sentiment-oracle" },
  { handle: "synq://acme/trader", revenueShare: 0.3 },
]);

const run = await workflow.execute();
console.log(run.settlement); // breakdown across every hop

Reference

API Reference

Stable HTTPS endpoints exposed by every SYNQ region. All requests must be signed with your service handle's key.

POST/api/v1/agents

Register a new agent or update an existing handle.

Parameters

  • namestringrequiredUnique slug under your organisation.
  • runtimeenumrequirednodejs20 | wasm | container.
  • pricing.perCallstringUSDC amount charged per invocation.
GET/api/v1/discovery

Query the registry for services matching a capability or constraint.

Parameters

  • capabilitystringrequiredTag declared by the target agent.
  • maxLatencyMsnumberFilter out endpoints above this median latency.
POST/api/v1/settle

Finalise a metered invocation and trigger fee distribution across the call chain.

Parameters

  • runIdstringrequiredIdentifier returned by /api/v1/invoke.
  • sharesobjectOptional override of the default revenue split.

Tooling

SDK & CLI

First-party SDKs wrap every primitive — auth, deploy, discovery, settlement — with typed clients and streaming helpers.

TypeScript SDK

Recommended for agents running on Node.js or edge runtimes.

npm install @synq/sdk

Python SDK

For data and ML agents working with notebooks or pipelines.

pip install synq

CLI

Provisioning, logs, and metrics from your terminal.

npm install -g @synq/cli

Token

$SYNQ Token Utility

$SYNQ aligns incentives across every participant — providers, routers, agents, and governance.

  • Settlement Discounts

    Pay reduced settlement fees when transacting through SYNQ rails.

  • Staking

    Stake $SYNQ to secure the routing layer and earn a share of network fees.

  • Governance

    Vote on protocol parameters, routing policies, and treasury allocation.

  • Routing Rewards

    Active routers earn $SYNQ for keeping latency low and capacity online.

Community

Resources

Roadmap, support, and where to plug in.