# Service APIs overview

> For the complete documentation index, see [llms.txt](https://bsvblockchain.com/docs/llms.txt).

Look up the HTTP and WebSocket APIs of BSV blockchain services: broadcasting, overlays, MessageBox, Merkle proofs, UHRP storage, wallet storage and HTTP 402 payments.

import BlueTable from '/snippets/BlueTable.jsx';

Find the reference, guide or specification for each BSV blockchain service API. The services expose HTTP APIs, and AuthSocket (A WebSocket protocol on Socket.IO with BRC-103 mutual authentication) uses WebSocket. For the hosts to call on each network, see [Network endpoints](https://bsvblockchain.com/docs/reference/networks/).

## HTTP APIs

<BlueTable>

| API | What it does | Reference | Guide or specification |
|---------|--------------|-----------|------------------------|
| ARC | Submits one transaction or a batch to ARC (The broadcaster that came before BSV Broadcaster. BSV Broadcaster keeps most of its request and response shapes, but the ARC class of @bsv/sdk does not work with it) and reports the status of a transaction by its ID | [ARC broadcast](https://bsvblockchain.com/docs/reference/arc/) | [Broadcast with BSV Broadcaster](https://bsvblockchain.com/docs/guides/services/broadcasting/) |
| Overlay | Accepts BEEF (Background Evaluation Extended Format (BRC-62): a transaction with the evidence a host needs to verify it.) transactions into an overlay service (Built from topic managers, which decide what is admitted, and lookup services, which query what was admitted.), answers lookup queries, lists the topic managers and lookup services it hosts, and exposes admin routes | [Overlay](https://bsvblockchain.com/docs/reference/overlay/) | [Run an overlay with @bsv/overlay-express](https://bsvblockchain.com/docs/sdk/packages/overlay-express/) |
| MessageBox | Holds messages for a named box on a MessageBox (A store-and-forward messaging service: it holds each message until its recipient reads it) server until the recipient lists and acknowledges them, and registers devices and permissions | [MessageBox](https://bsvblockchain.com/docs/reference/message-box/) | [Send messages with @bsv/message-box-client](https://bsvblockchain.com/docs/sdk/packages/message-box-client/) |
| Merkle service | Watches transaction IDs and sends each BUMP (BSV Unified Merkle Path (BRC-74): a compact proof that a transaction is in a block) to a callback URL when the proof is available | [Merkle service](https://bsvblockchain.com/docs/reference/merkle-service/) | [Merkle service specification](https://bsv-blockchain.github.io/ts-stack/specs/merkle-service/) |
| File storage | Uploads a file to a UHRP (Universal Hash Resolution Protocol (BRC-26): file storage where a file is found by the hash of its content) storage server, finds who hosts a hash, lists uploads and renews an advertisement | [UHRP storage](https://bsvblockchain.com/docs/reference/uhrp/) | [UHRP specification](https://bsv-blockchain.github.io/ts-stack/specs/uhrp/) |
| Wallet storage | Exposes a remote wallet storage provider over HTTP: actions, outputs, certificates and sync | [Wallet storage](https://bsvblockchain.com/docs/reference/wallet-storage/) | [Plug in your own storage](https://bsvblockchain.com/docs/wallet-dev/wallet-toolbox/storage-adapter/) |
| BRC-121 payments | Charges for an HTTP resource. The resource answers `402 Payment Required` with the `x-bsv-sats` and `x-bsv-server` headers, and the client repeats the request with a payment | [BRC-121 payments](https://bsvblockchain.com/docs/reference/brc-121/) | [Gate an API behind payments](https://bsvblockchain.com/docs/guides/payments/) |

</BlueTable>

## Protocols

[ts-stack](https://bsv-blockchain.github.io/ts-stack/) describes these protocols as AsyncAPI specifications:

**[AuthSocket WebSocket protocol](https://bsvblockchain.com/docs/reference/http-apis/authsocket/)**

Socket.IO with BRC-103 (Mutual authentication, where the wallet and the server prove their identity keys to each other) authentication, where each side signs its messages and the other verifies them.

**[BRC-103 mutual authentication](https://bsvblockchain.com/docs/reference/http-apis/brc-103-mutual-auth/)**

The handshake in which a client and a server prove their identity keys to each other, used by MessageBox and AuthSocket.

BRC-29 and GASP have no page on this site. Their specifications are in ts-stack:

- [BRC-29](https://bsv-blockchain.github.io/ts-stack/specs/brc-29-peer-payment/) covers peer-to-peer payments with a payment address derived from both identity keys.
- GASP (Graph Aware Sync Protocol, how two overlay nodes synchronize transaction state) syncs transaction state between two overlay nodes, as described in its [specification](https://bsv-blockchain.github.io/ts-stack/specs/gasp-sync/).

## Related articles

To learn more about service APIs on the BSV blockchain, review these articles:

- [How the stack fits](https://bsvblockchain.com/docs/concepts/architecture/)