API

Matcher API

The matcher exposes a small HTTPS surface for submitting, cancelling, and querying intents. All mutating calls require the original EIP-712 signature. Dummy host: https://matcher.shade.invalid/v1.

POST /intents

Submit a signed intent. The matcher acknowledges storage; it does not guarantee a fill.

{
  "intent": { "poolId": "0x…", "amountIn": "10000000000000000000" },
  "signature": "0x…"
}

POST /intents/:id/cancel

Invalidate a nonce. The client should also expect the on-chain bitmap to be updated at next settlement, or via a dedicated cancel solver transaction if the intent must be killed immediately.

GET /intents/:id

Returns status: pending, matched, executed, or cancelled.

GET /analytics/volume

Daily notional settled through the hook, quoted in USD. This is the series rendered on /app/analytics. Values are delayed by one block after Fill events.

Authentication

Read endpoints are public. Write endpoints authenticate by recovering the signer from the provided signature — there are no API keys for traders.