Router

How it worksCopy Anchor Link

Router stores what the venue reports. The venue's engine matches the order and keeps the coin. Switch Router on when the venue wants the protocol to hold the quote and the fill.

QuoteCopy Anchor Link

$ curl -s -X POST https://api.opfico.network/router/quotes -H 'content-type: application/json' -d @quote.json
201 Created

{
  "venue": "harbour",
  "market": "eth-4k-week",
  "maker": "<solana pubkey>",
  "orders": []
}

A blocked maker or a blocked venue is refused.

FillCopy Anchor Link

$ curl -s -X POST https://api.opfico.network/router/fills -H 'content-type: application/json' -d @fill.json
201 Created

{
  "id": "fill-eth-1",
  "venue": "harbour",
  "market": "eth-4k-week",
  "maker": "<solana pubkey>",
  "collateral": "USDC",
  "txRef": "venue-tx-id",
  "fill": { "price": 0.59, "shares": 20 }
}

collateral is the venue's coin. txRef is the venue transaction id, when there is one. fill is the venue's own fill object.

Rewards turns that row into a credit from that venue, in that coin. It skips a blocked maker, a blocked settlement address, and a paused venue.

GET /fills?venue=&maker= returns the stored rows.