Skip to main content

GET /prices

Snapshot of token prices used by the Invoice Manager when matching deposits to invoice values. Public, unauthenticated.

Response​

{
  "vsCurrency": "usd",
  "fetchedAt": 1730393900,
  "prices": {
    "1:0xdac17f958d2ee523a2206206994597c13d831ec7": 1.0,
    "1:0x0000000000000000000000000000000000000000": 2456.32,
    "56:0x55d398326f99059ff775485246999027b3197955": 1.0
  }
}

Keys are "{chainId}:{tokenAddress}", values are decimals in vsCurrency. The same lookup table is what backs the vsValue field on payment records.

GET /ws

WebSocket subscription for real-time invoice events — same payload shape as POST /poll/events but pushed instead of pulled.

wss://api.feemaker.io/ws

The first message after connection is an auth challenge; respond with a session-signed register frame. See the example in apps/webwallet for the complete handshake (hooks/useInvoiceSigner.ts). For most backend integrations the polling endpoint is simpler and fully equivalent.