# HTTP reference

> SWQoS HTTP routes for raw transactions and bundles, health checks and tip floor snapshots

<Note>
Supanode issues keys through [Telegram](https://telegram.me/supanode_tgs). Default minimum tip: 0.001 SOL; default rate: 15 sends/s per key per metro. Your key settings can differ. Declared tips are off by default and require enablement and a payment arrangement with Supanode. If your key returns `partner_declared_tips`, use an on-chain transfer instead.
</Note>

Use the same [hosts and ports](https://supanode.xyz/docs/solana/sender/endpoints) as JSON-RPC. Authenticate with an [API key](https://supanode.xyz/docs/solana/sender/api-keys), except for `GET /health`.

| Route | Request | Response |
| --- | --- | --- |
| [`POST /binary`](https://supanode.xyz/docs/solana/sender/reference/http/binary) | Raw transaction bytes or a payload envelope | Transaction signature or bundle ID as plain text |
| [`POST /plaintext`](https://supanode.xyz/docs/solana/sender/reference/http/plaintext) | The same payload encoded as base64 text | Transaction signature or bundle ID as plain text |
| [`GET /health`](https://supanode.xyz/docs/solana/sender/reference/http/health) | No body or API key | `ok` or `unhealthy` as plain text |
| [`GET /tip_floor`](https://supanode.xyz/docs/solana/sender/reference/http/tip-floor) | No body | Array of zero or one tip floor snapshots |
| `POST` to any other path | [JSON-RPC request](https://supanode.xyz/docs/solana/sender/reference/json-rpc#request) | JSON-RPC response |
| Any other method or path | Unsupported route | HTTP `404`, reason `invalid_request`, problem `not_found` |

The [payload envelope](https://supanode.xyz/docs/solana/sender/reference/payload-envelope) defines transaction, bundle and declared tip payloads. Raw sends have no preflight simulation. Each route reference defines its body limits, responses and examples.

Raw HTTP refusals return a JSON [rejection object](https://supanode.xyz/docs/solana/sender/reference/errors) in the response body. A successful send acknowledges acceptance; check landing through your Solana RPC provider as described in [Confirmation and retries](https://supanode.xyz/docs/solana/sender/confirmation).

## OpenAPI

Import [`http.json`](https://supanode.xyz/sender/openapi/http.json) for the raw submission routes, [`health.json`](https://supanode.xyz/sender/openapi/health.json) for health or [`tip-floor.json`](https://supanode.xyz/sender/openapi/tip-floor.json) for the tip floor. The last two documents also include their JSON-RPC methods.
