Skip to content

Palisade API (2.0)

The Palisade API enables programmatic interaction with the various features of the Palisade platform

Download OpenAPI description
Languages
Servers
Mock server
https://docs.ripple.com/_mock/products/wallet/api-docs/palisade-api/palisade-api
Sandbox server (uses TESTNET data, private keys and accounts)
https://api.sandbox.palisade.co
Palisade server (uses MAINNET data, private keys and accounts)
https://api.palisade.co
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations

Used to view information about the platform

Operations
Operations
Operations
Operations
Operations
Operations
Operations

Used to manage sweep configurations

Operations
Operations
Operations

Used to manage XRP specific transactions

Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations

Request

Soft delete a blockchain from the registry

Security
TokenAuth
Path
idstringrequired

The blockchain ID to delete

Enum"AVALANCHE""ETHEREUM""XRP_LEDGER""POLYGON""BNBCHAIN""BASE""HEDERA""ARBITRUM""ONE_MONEY""SOLANA"
curl -i -X DELETE \
  'https://docs.ripple.com/_mock/products/wallet/api-docs/palisade-api/palisade-api/v2/blockchains/{id}' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

A successful response.

Bodyapplication/json
object(v2ManagementDeleteBlockchainResponse)
Response
application/json
{}

Request

Update an existing blockchain configuration

Security
TokenAuth
Path
idstringrequired

The blockchain ID to update

Enum"AVALANCHE""ETHEREUM""XRP_LEDGER""POLYGON""BNBCHAIN""BASE""HEDERA""ARBITRUM""ONE_MONEY""SOLANA"
Bodyapplication/jsonrequired
namestring

Updated blockchain name

Example: "Ethereum Mainnet"
namespacestring

Updated namespace

Example: "ethereum"
chainstring

Updated chain identifier

Example: "mainnet"
chainIdstring

Updated chain ID

Example: "1"
routingstring

Updated routing configuration

Example: "primary"
statusstring(v2BlockchainStatus)
Enum"RPC_ENDPOINT_TYPE_ENABLED""RPC_ENDPOINT_TYPE_DISABLED"
supportsWalletConnectboolean

Updated WalletConnect support

Example: true
curl -i -X PATCH \
  'https://docs.ripple.com/_mock/products/wallet/api-docs/palisade-api/palisade-api/v2/blockchains/{id}' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Ethereum Mainnet",
    "namespace": "ethereum",
    "chain": "mainnet",
    "chainId": "1",
    "routing": "primary",
    "status": "RPC_ENDPOINT_TYPE_ENABLED",
    "supportsWalletConnect": true
  }'

Responses

Bodyapplication/json
idstring(v2Blockchain)required
Enum"AVALANCHE""ETHEREUM""XRP_LEDGER""POLYGON""BNBCHAIN""BASE""HEDERA""ARBITRUM""ONE_MONEY""SOLANA"
namestringrequired

Human-readable name of the blockchain

Example: "Ethereum"
namespacestringrequired

The CAIP-2 namespace identifier

Example: "eip155"
chainIdstringrequired

The chain ID (supports large numbers)

Example: "1"
rpcEndpointsArray of objects(v2RPCEndpoint)

RPC endpoints for blockchain connectivity

supportedEventsArray of strings

WalletConnect event types supported by this blockchain

supportedMethodsArray of strings

WalletConnect methods supported by this blockchain

keystoreTypesArray of strings(v2Keystore)

Supported keystore types (HSM, MPC)

Items Enum"HSM""MPC"
keyAlgorithmsArray of strings(v2KeyAlgorithm)

Supported key algorithms

Items Enum"SECP256K1""ED25519"
routingstringrequired

Message queue routing key base

Example: "ethereum"
statusstring(v2BlockchainStatus)required
Enum"RPC_ENDPOINT_TYPE_ENABLED""RPC_ENDPOINT_TYPE_DISABLED"
supportsWalletConnectboolean

Whether this blockchain supports WalletConnect

explorersArray of objects(v2Explorer)

Blockchain explorers for viewing transactions and addresses

createdAtstring(date-time)read-only

When the blockchain was created

updatedAtstring(date-time)read-only

When the blockchain was last updated

chainstring

Chain identifier (e.g., 'ethereum-mainnet', 'ethereum-goerli')

Example: "ethereum-mainnet"
coingeckoPlatformIdstring

CoinGecko platform identifier for sync (optional for testnets)

Example: "ethereum"
checksumTypestring(v2ChecksumType)
Enum"CHECKSUM_TYPE_NONE""CHECKSUM_TYPE_EIP55""CHECKSUM_TYPE_BASE58CHECK""CHECKSUM_TYPE_XRP"
blockTimeinteger(int32)

Average block time in seconds

Example: 12
confirmationBlocksinteger(int32)

Recommended number of confirmations for finality

Example: 6
Response
application/json
{ "id": "AVALANCHE", "name": "Ethereum", "namespace": "eip155", "chainId": "1", "rpcEndpoints": [ {} ], "supportedEvents": [ "string" ], "supportedMethods": [ "string" ], "keystoreTypes": [ "HSM" ], "keyAlgorithms": [ "SECP256K1" ], "routing": "ethereum", "status": "RPC_ENDPOINT_TYPE_ENABLED", "supportsWalletConnect": true, "explorers": [ {} ], "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "chain": "ethereum-mainnet", "coingeckoPlatformId": "ethereum", "checksumType": "CHECKSUM_TYPE_NONE", "blockTime": 12, "confirmationBlocks": 6 }

Request

List blockchains with advanced filtering. Supports both GET (bookmarkable) and POST (complex filters).

Security
TokenAuth
Bodyapplication/jsonrequired
filterobject(v2BlockchainFilter)
searchobject(v2SearchQuery)
paginationobject(v2PaginationRequest)
curl -i -X POST \
  https://docs.ripple.com/_mock/products/wallet/api-docs/palisade-api/palisade-api/v2/blockchains:list \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "filter": {
      "status": {
        "eq": 0,
        "notEq": 0,
        "in": [
          0
        ],
        "notIn": [
          0
        ],
        "isNull": true,
        "gt": 0,
        "gte": 0,
        "lt": 0,
        "lte": 0
      },
      "name": {
        "eq": "string",
        "notEq": "string",
        "contains": "string",
        "startsWith": "string",
        "endsWith": "string",
        "in": [
          "string"
        ],
        "notIn": [
          "string"
        ],
        "regex": "string",
        "isNull": true,
        "fuzzy": {
          "value": "string",
          "minSimilarity": 0.1
        }
      },
      "chainId": {
        "eq": "string",
        "notEq": "string",
        "contains": "string",
        "startsWith": "string",
        "endsWith": "string",
        "in": [
          "string"
        ],
        "notIn": [
          "string"
        ],
        "regex": "string",
        "isNull": true,
        "fuzzy": {
          "value": "string",
          "minSimilarity": 0.1
        }
      },
      "checksumType": {
        "eq": 0,
        "notEq": 0,
        "in": [
          0
        ],
        "notIn": [
          0
        ],
        "isNull": true,
        "gt": 0,
        "gte": 0,
        "lt": 0,
        "lte": 0
      },
      "chain": {
        "eq": "string",
        "notEq": "string",
        "contains": "string",
        "startsWith": "string",
        "endsWith": "string",
        "in": [
          "string"
        ],
        "notIn": [
          "string"
        ],
        "regex": "string",
        "isNull": true,
        "fuzzy": {
          "value": "string",
          "minSimilarity": 0.1
        }
      }
    },
    "search": {
      "term": "stable",
      "fields": [
        "name",
        "symbol"
      ],
      "type": "SEARCH_TYPE_CONTAINS",
      "minScore": 0.1,
      "options": {
        "caseSensitive": true,
        "minTermLength": 0,
        "maxResults": 0,
        "multiTermAnd": true
      }
    },
    "pagination": {
      "pageSize": 50,
      "pageToken": "cGFnZV9zaXplPTEwJnBhZ2VfdG9rZW49MjA=",
      "orderBy": "created_at",
      "order": "SORT_ORDER_ASC"
    }
  }'

Responses

A successful response.

Bodyapplication/json
blockchainsArray of objects(v2BlockchainInfo)
paginationobject(v2PaginationResponse)
Response
application/json
{ "blockchains": [ {} ], "pagination": { "previousPageToken": "cGFnZV9zaXplPTEwJnBhZ2VfdG9rZW49MjA=", "nextPageToken": "cGFnZV9zaXplPTEwJnBhZ2VfdG9rZW49MjA=", "total": 100 } }
Operations
Operations