Skip to main content
POST
/
deposit-addresses
Create new deposit address
curl --request POST \
  --url https://api.rhino.fi/bridge/deposit-addresses \
  --header 'Content-Type: application/json' \
  --header 'authorization: <api-key>' \
  --data '{
  "depositChains": [
    "<string>"
  ],
  "destinationChain": "<string>",
  "destinationAddress": "<string>",
  "tokenOut": "<string>",
  "addressNote": "<string>",
  "reusePolicy": "create-new",
  "postBridgeData": {
    "_tag": "extended",
    "vaultId": 1
  },
  "webhookUrl": "<string>",
  "refundAddress": "<string>",
  "bridgeIfNotSwappable": true
}'
[
  {
    "depositChain": "<string>",
    "depositAddress": "<string>",
    "destinationChain": "<string>",
    "destinationAddress": "<string>",
    "addressNote": "<string>",
    "supportedTokens": [
      {
        "symbol": "<string>",
        "address": "<string>",
        "maxDepositLimitUsd": 1,
        "minDepositLimitUsd": 1
      }
    ],
    "isActive": true,
    "postBridgeData": {
      "_tag": "extended",
      "vaultId": 1
    },
    "tokenOut": "<string>",
    "refundAddress": "<string>",
    "bridgeIfNotSwappable": true
  }
]

Authorizations

​
authorization
string
header
required

Body

application/json
​
depositChains
string[]
required
Minimum length: 1

a non empty string

​
destinationChain
string
required

a non empty string

Minimum length: 1
​
destinationAddress
string
required

a non empty string

Minimum length: 1
​
tokenOut
string

Token to be received on the destination address. The deposited token will be swapped automatically if needed.

Minimum length: 1
​
addressNote
string

a string at most 80 character(s) long

Maximum length: 80
​
reusePolicy
enum<string>

Whether to reuse an existing deposit address that matches the given parameters or always create a new one. By default an existing address is reused unless create-new is specified.

Available options:
create-new,
reuse-existing
​
postBridgeData
object
  • Option 1
  • Option 2
  • Option 3
  • Option 4
​
webhookUrl
string
​
refundAddress
string

a non empty string

Minimum length: 1
​
bridgeIfNotSwappable
boolean

Only valid if tokenOut is set as well. If true, deposited tokens that cannot be swapped to the tokenOut will be bridged instead of causing a failed bridge.

Response

Success

​
depositChain
string
required

a non empty string

Minimum length: 1
​
depositAddress
string
required

a non empty string

Minimum length: 1
​
destinationChain
string
required

a non empty string

Minimum length: 1
​
supportedTokens
object[]
required
​
isActive
boolean
required
​
destinationAddress
string

a non empty string

Minimum length: 1
​
addressNote
string

a string at most 80 character(s) long

Maximum length: 80
​
postBridgeData
object
  • Option 1
  • Option 2
  • Option 3
  • Option 4
​
tokenOut
string
​
refundAddress
string

a non empty string

Minimum length: 1
​
bridgeIfNotSwappable
boolean