Phoenixd API Reference

Use your node's Phoenixd API for actions inside a running node: creating Lightning invoices, checking balances and payments, and sending payments. These requests go to your node's endpoint, not to the Nodana API.

Nodana gives each node an endpoint and Phoenixd credentials when you create it. Use the node's Phoenixd password to authenticate requests to that endpoint. Keep the password in your backend or a trusted secret store; do not put it in browser code.

The official Phoenixd API Reference documents the available endpoints, request fields, and responses.

Example: list payments

Use your node's endpoint and Phoenixd password to list incoming payments. This example includes Phoenixd's all, limit, and offset options:

$ curl 'https://node-abcd.nodana.app:9740/payments/incoming?all=true&limit=5&offset=2' \
    -u ':YOUR_PHOENIXD_PASSWORD'

To list outgoing payments, use the outgoing path:

$ curl 'https://node-abcd.nodana.app:9740/payments/outgoing' \
    -u ':YOUR_PHOENIXD_PASSWORD'

Replace the example URL with your node's endpoint and the placeholder password with its Phoenixd password. Keep the password out of shared scripts and logs.

Use the Nodana API for hosting and lifecycle actions such as creating, listing, starting, stopping, updating, and deleting nodes. A Nodana API key manages Nodana resources and is not a Phoenixd password.