> For the complete documentation index, see [llms.txt](https://docs.titanbuilder.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.titanbuilder.xyz/solana.md).

# Solana

Titan's Solana bundle API takes bundles and transactions from searchers and includes them in the blocks Titan builds. Titan is a block builder on [GBX](https://docs.gravityblocks.xyz/), an open marketplace for Solana blockspace. The gRPC protos and an example client are at [gattaca-com/solana-protos](https://github.com/gattaca-com/solana-protos).

### Quick start

1. Call `GetConnectedLeaders` to learn which upcoming slots have a leader connected to GBX.
2. Pick the endpoint closest to the leader or your servers. No key or token is needed.
3. Build a bundle of up to 5 signed transactions, with a tip to a Titan tip account, and use `SendBundle` to send it.

Titan builds blocks only for validators connected to GBX, so a bundle can land only in those validators' slots.

### Endpoints

<table><thead><tr><th width="204.8531494140625">Region</th><th>Endpoint</th></tr></thead><tbody><tr><td>Amsterdam</td><td><code>https://sol-ams.titanbuilder.xyz</code></td></tr><tr><td>Frankfurt</td><td><code>https://sol-fra.titanbuilder.xyz</code></td></tr><tr><td>London</td><td><code>https://sol-lon.titanbuilder.xyz</code></td></tr><tr><td>Tokyo</td><td><code>https://sol-tyo.titanbuilder.xyz</code></td></tr></tbody></table>

Every region streams to Titan builders in all regions. We recommend sending to the region closest to the leader.

### Tipping

Minimum tip is 5000 lamports. Higher tips will result in higher priority. `GetTipAccounts` returns the Titan tip accounts:

```
xk95T6h7nFSRZepEf6JGdv9BCvZLER6dDGXg2KmJ1t1
AEg8jYwFpEYXaVd3jMpxPu8V1HXvSvmZr9ms8wm4ub1a
HiLntniupDE3Y18j8BtoMtE6MxQdXRfJw3xYCKfBt3t5
8bXKHaeUzcYGr8ag8WJVdg2Etiy8vw3TCcb5f3dQ4xaq
HtmPJ2k1SzFzLE6Zdu7RXqGxgDPKx2C5Hkdu189B7TXe
5yjjgHRL8q4uuWXsg3CAvBJdLQ3NUDwJK17EjHHeCorX
DDceWhu2X1x38FWGzjPXnNGnKqJwPYHqTX4Xr2gd6xbW
2bERRYFDaZfMNN4TwiFLgm5wntZ457YnmpRBrpSUw9Aj
```

* Pick one account at random for each bundle so your bundles do not all write-lock the same account.
* Add the tip as a static instruction in your transaction (no CPI).

### Access and rate limits

The base rate limit is 5 requests per second.

If you need a higher rate or need a customised set up, reach out on [Discord](https://discord.gg/hnerZ7dhTk).