> For the complete documentation index, see [llms.txt](https://sm-fund.gitbook.io/sm-fund-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sm-fund.gitbook.io/sm-fund-docs/reference/raw-feed.md).

# Raw Polygon pending feed

The raw feed is a server-push stream of the original JSON-RPC pending-transaction notification text accepted by the service. It does not decode or project the transaction for the client.

| Item               | Value                                            |
| ------------------ | ------------------------------------------------ |
| URL                | `wss://stream.sm.fund/ws?feed=raw`               |
| Subprotocol        | `polygon.pending.v1`                             |
| Authentication     | `Authorization: Bearer <WSS_TICKET>`             |
| Server frame       | UTF-8 JSON text                                  |
| Client data frames | Not supported; the connection closes with `1008` |

Obtain the ticket from [the ticket endpoint](/sm-fund-docs/reference/tickets.md). Keep the API key on the server that requests the ticket; never send it on this WebSocket.

## Notification shape

The feed forwards a pending transaction notification with `method` equal to `eth_subscription` and an object in `params.result`. The transaction result can contain additional fields. This example is fictional and intentionally incomplete:

```json
{
  "jsonrpc": "2.0",
  "method": "eth_subscription",
  "params": {
    "subscription": "0x0123456789abcdef",
    "result": {
      "hash": "0x1111111111111111111111111111111111111111111111111111111111111111",
      "to": "0x2222222222222222222222222222222222222222",
      "input": "0x",
      "blockNumber": null
    }
  }
}
```

The outer notification text is forwarded as received. Unknown fields, field order, whitespace, integer values, and `null` values in that notification are preserved. The service does not add metadata. Subscription acknowledgements, RPC errors, and WebSocket heartbeat frames are transport messages and are not delivered as raw feed data.

Clients do not send a subscription command. Delivery starts automatically with pending transaction notifications. The raw feed does not promise that every pending transaction is visible, and it provides no replay, cursor, or acknowledgement mechanism.

## Connection behavior

Free adds a fixed 500 ms delivery delay; Developer adds no delivery delay. The delay is applied per event and does not accumulate. Raw and Polymarket connections share one per-user slot across all API keys and both feeds. When a newer valid connection is registered, the old one closes with `4001 connection replaced`. See [error handling](/sm-fund-docs/reference/errors.md) and [connection lifecycle](/sm-fund-docs/guides/connection-lifecycle.md) for recovery guidance. See [plans and billing](/sm-fund-docs/get-started/plans-and-billing.md) for plan details.

Do not send application text or binary frames. The service closes such a client frame with `1008`.