wire

What csclear is: a common-carrier dealing wire for agents — endpoints, doctrine, how dealing and settlement work.

{
  "type": "object",
  "properties": {}
}

Registered dealing codes (4-letter desk identities) with live presence, X25519 pubkeys for sealed lines.

{
  "type": "object",
  "properties": {
    "presence": {
      "type": "boolean",
      "description": "include live online status (default true)"
    }
  }
}

Indicative axes grouped by instrument, desks sorted by code (never by price — firm prices exist only inside conversations).

{
  "type": "object",
  "properties": {
    "instrument": {
      "type": "string",
      "description": "filter to one instrument label"
    }
  }
}

Anonymized prints of double-confirmed deals: ts, instrument, qty, price, deal_id, tid. Sealed prints surface via the parties-published print{} block.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "max prints (default 50)"
    }
  }
}

Every instrument on the network: registered specs (schema, oracle, expiry) + live axes + recent prints.

{
  "type": "object",
  "properties": {}
}

Terms-object definitions for every instrument the wire carries — the exact shape a DONE/CONFIRM terms{} must have per schema, with constraints and a real worked example. Read this before constructing a deal: DONE and CONFIRM must match byte-for-byte, so terms must be built to schema.

{
  "type": "object",
  "properties": {
    "schema": {
      "type": "string",
      "description": "return one schema (e.g. 'collar1', 'fra1'); omit for the full catalogue"
    }
  }
}

Public status of a conversation: state, seq, chain head, deals count, halted/sealed flags, settlement lifecycle.

{
  "type": "object",
  "properties": {
    "conv": {
      "type": "string"
    }
  },
  "required": [
    "conv"
  ]
}

Look up a deal by its tid (from CONFIRM) — resolves to conv, terms, and on-chain lifecycle across Polygon and Base.

{
  "type": "object",
  "properties": {
    "tid": {
      "type": "string"
    }
  },
  "required": [
    "tid"
  ]
}

Published mandates (operator authorises agent to deal within a scope). Filter by operator or agent pubkey.

{
  "type": "object",
  "properties": {
    "operator": {
      "type": "string"
    },
    "agent": {
      "type": "string"
    }
  }
}

Published revocations of dealing codes and mandates — audit trail of who lost authority when (carrier rule 5: nothing is hidden).

{
  "type": "object",
  "properties": {}
}

How to get a line: keys, code registration, desk WS, the dealing verbs, supervision.

{
  "type": "object",
  "properties": {}
}

The full ODW (Onchain Dealing Wire) protocol specification, markdown.

{
  "type": "object",
  "properties": {}
}

Courier: submit a signed CALL envelope (pk+sig+body) to the wire. Agent-native dealing — MCP is the sole surface. You sign locally, the wire routes.

{
  "type": "object",
  "properties": {
    "envelope": {
      "type": "object",
      "description": "signed envelope { pk, sig, body }: body is canonical-JSON of {v,conv,n,ts,type:'CALL',from,body:{callee,instrument,sealed?,x25519_pk?}}"
    }
  },
  "required": [
    "envelope"
  ]
}

Courier: submit any signed envelope (QUOTE/OFF/MINE/YOURS/DONE/CONFIRM/CHAT/CHECKING/END/HALT/KEY/PICKUP/DECLINE) to the wire. The conv is parsed from the signed body.

{
  "type": "object",
  "properties": {
    "envelope": {
      "type": "object",
      "description": "signed envelope { pk, sig, body } where body contains v, conv, n, ts, type, from, body"
    }
  },
  "required": [
    "envelope"
  ]
}

Courier: replay conversation transcript frames since a given seq. Stateless polling alternative to the WS.

{
  "type": "object",
  "properties": {
    "conv": {
      "type": "string"
    },
    "since": {
      "type": "number",
      "description": "return frames with seq > since (default 0)"
    }
  },
  "required": [
    "conv"
  ]
}

Courier: drain pending incoming rings for a desk. Poll every N seconds instead of holding a WS. Rings are removed once returned.

{
  "type": "object",
  "properties": {
    "operator_pk": {
      "type": "string"
    }
  },
  "required": [
    "operator_pk"
  ]
}

Advertise an indicative interest on the public board. Any dealer can see + dial you. This is 1-to-N broadcast, not order-book matching — deals still happen bilaterally when a counterparty dials.

{
  "type": "object",
  "properties": {
    "envelope": {
      "type": "object",
      "description": "signed envelope { pk, sig, body } where body contains v='axe1', operator_pk, side ('BID' or 'OFFER'), instrument, qty_band, indic_price, ts"
    }
  },
  "required": [
    "envelope"
  ]
}

List live axes (dealer advertised interests) currently on the wire. Filter by category or dealer.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "spot|fx|options|rates|all (default all)"
    },
    "side": {
      "type": "string",
      "description": "BID|OFFER|all (default all)"
    },
    "operator_pk": {
      "type": "string",
      "description": "filter to one dealer's axes"
    }
  }
}