Skip to content

Getting Started

tip

All HTTP requests have to be sent with the Content-Type: application/json header. If the header is not present it will result in malformed responses or request rejections.

This is the reference guide for the Public API. This API exposes all resources and data provided by a Solar Core node and is the preferred way of interacting with the Solar Network.

info

Each Core instance has its own internal blockchain and state, meaning it may have forked or be out of sync, causing queries to fail. Monitor your node by comparing it to different public nodes, such as the official Mainnet or Testnet Explorer to ensure you are in sync.

If you have any problems or requests, please open an issue.

Pagination

Requests that return multiple items will be paginated to 100 items by default. You can specify further pages with the ?page parameter. For some resources, you can also set a custom page size up to 100 with the ?limit parameter. Note that for technical reasons not all endpoints respect the ?limit parameter.

Public Testing Relay

If you are not running a relay yourself you can test API calls using:

Mainnet API
api.solar.org
Testnet API
tapi.solar.org

Self-Hosted Relay Port

When running a self-hosted Core relay instance, the default API port is 6003 (e.g., <your_relay's_ip>:6003/api).

Be sure to configure your firewall appropriately.

warning

It's strongly advised to only enable API access on a relay node and never on a delegate forging node.

Happy Developing!