Subscribe to webhooks

You can either setup your webhook URL once for your project in the developer portal or pass it on invidual bridges.

Using developer portal

Go to Rhino.fi developer portal and select your project.

Under the Webhooks section you can define your webhook URL.

Please make sure NOT to include the endpoint name /rhinofi-event.

You provide: https://my-server.com/prefix

Rhino.fi calls: https://my-server.com/prefix/rhinofi-event

Once defined you’ll get webhook events for all the bridges associated with this project. You don’t need to pass the webhookUrl parameter every time you get a quote as described in the next section.

Bridge API

To subscribe to webhooks when using Rhino.fi bridge API, you can pass a webhookUrl parameter when getting a bridge quote.

You’ll then start receiving webhook events on all your bridge status changes (full list of bridge events).

Example:

webhookUrl: "https://my-server.com/prefix"

Please make sure NOT to include the endpoint name /rhinofi-event.

You provide: https://my-server.com/prefix

Rhino.fi calls: https://my-server.com/prefix/rhinofi-event

For the exact specification, see the API Reference

Smart Deposit Addresses API

To subscribe to webhooks when using Rhino.fi Smart Deposit Addresses API, you can pass a webhookUrl parameter when create a deposit address.

You’ll then start receiving webhook events on all operations done on this deposit address (full list of bridge events).

Example:

webhookUrl: "https://my-server.com/prefix"

Please make sure NOT to include the endpoint name /rhinofi-event.

You provide: https://my-server.com/prefix

Rhino.fi calls: https://my-server.com/prefix/rhinofi-event

For the exact specification, see the API Reference