The Palisade API enables programmatic interaction with the various features of the Palisade platform
https://docs.ripple.com/_mock/products/palisade/api-docs/palisade-api/palisade-api-1/
https://api.sandbox.palisade.co/
https://api.palisade.co/
Relative days from now (negative for past, positive for future)
Type of search to perform
- SEARCH_TYPE_CONTAINS: Default substring search
- SEARCH_TYPE_STARTS_WITH: Prefix search
- SEARCH_TYPE_EXACT: Exact match
- SEARCH_TYPE_FUZZY: Fuzzy/similarity search
- SEARCH_TYPE_FULLTEXT: Full-text search (future)
- Mock server
https://docs.ripple.com/_mock/products/palisade/api-docs/palisade-api/palisade-api-1/v2/assets
- Sandbox server (uses TESTNET data, private keys and accounts)
https://api.sandbox.palisade.co/v2/assets
- Palisade server (uses MAINNET data, private keys and accounts)
https://api.palisade.co/v2/assets
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://docs.ripple.com/_mock/products/palisade/api-docs/palisade-api/palisade-api-1/v2/assets?filter.blockchain.eq=0&filter.blockchain.notEq=0&filter.blockchain.in=0&filter.blockchain.notIn=0&filter.blockchain.isNull=true&filter.blockchain.gt=0&filter.blockchain.gte=0&filter.blockchain.lt=0&filter.blockchain.lte=0&filter.enabled.eq=true&filter.enabled.isNull=true&filter.isVetted.eq=true&filter.isVetted.isNull=true&filter.standard.eq=0&filter.standard.notEq=0&filter.standard.in=0&filter.standard.notIn=0&filter.standard.isNull=true&filter.standard.gt=0&filter.standard.gte=0&filter.standard.lt=0&filter.standard.lte=0&filter.organizationId.eq=string&filter.organizationId.notEq=string&filter.organizationId.contains=string&filter.organizationId.startsWith=string&filter.organizationId.endsWith=string&filter.organizationId.in=string&filter.organizationId.notIn=string&filter.organizationId.regex=string&filter.organizationId.isNull=true&filter.organizationId.fuzzy.value=string&filter.organizationId.fuzzy.minSimilarity=0.1&filter.symbol.eq=string&filter.symbol.notEq=string&filter.symbol.contains=string&filter.symbol.startsWith=string&filter.symbol.endsWith=string&filter.symbol.in=string&filter.symbol.notIn=string&filter.symbol.regex=string&filter.symbol.isNull=true&filter.symbol.fuzzy.value=string&filter.symbol.fuzzy.minSimilarity=0.1&filter.name.eq=string&filter.name.notEq=string&filter.name.contains=string&filter.name.startsWith=string&filter.name.endsWith=string&filter.name.in=string&filter.name.notIn=string&filter.name.regex=string&filter.name.isNull=true&filter.name.fuzzy.value=string&filter.name.fuzzy.minSimilarity=0.1&filter.contractAddress.eq=string&filter.contractAddress.notEq=string&filter.contractAddress.contains=string&filter.contractAddress.startsWith=string&filter.contractAddress.endsWith=string&filter.contractAddress.in=string&filter.contractAddress.notIn=string&filter.contractAddress.regex=string&filter.contractAddress.isNull=true&filter.contractAddress.fuzzy.value=string&filter.contractAddress.fuzzy.minSimilarity=0.1&filter.source.eq=string&filter.source.notEq=string&filter.source.contains=string&filter.source.startsWith=string&filter.source.endsWith=string&filter.source.in=string&filter.source.notIn=string&filter.source.regex=string&filter.source.isNull=true&filter.source.fuzzy.value=string&filter.source.fuzzy.minSimilarity=0.1&filter.lastSyncedAt.eq=2019-08-24T14%3A15%3A22Z&filter.lastSyncedAt.notEq=2019-08-24T14%3A15%3A22Z&filter.lastSyncedAt.before=2019-08-24T14%3A15%3A22Z&filter.lastSyncedAt.after=2019-08-24T14%3A15%3A22Z&filter.lastSyncedAt.gte=2019-08-24T14%3A15%3A22Z&filter.lastSyncedAt.lte=2019-08-24T14%3A15%3A22Z&filter.lastSyncedAt.between.start=2019-08-24T14%3A15%3A22Z&filter.lastSyncedAt.between.end=2019-08-24T14%3A15%3A22Z&filter.lastSyncedAt.isNull=true&filter.lastSyncedAt.relativeDays=0&filter.hasChecksum.eq=true&filter.hasChecksum.isNull=true&search.term=string&search.fields=string&search.type=SEARCH_TYPE_CONTAINS&search.minScore=0.1&search.options.caseSensitive=true&search.options.minTermLength=0&search.options.maxResults=0&search.options.multiTermAnd=true&pagination.pageSize=0&pagination.pageToken=string&pagination.orderBy=string&pagination.order=SORT_ORDER_ASC' \
-H 'Authorization: YOUR_API_KEY_HERE'{ "assets": [ { … } ], "pagination": { "previousPageToken": "cGFnZV9zaXplPTEwJnBhZ2VfdG9rZW49MjA=", "nextPageToken": "cGFnZV9zaXplPTEwJnBhZ2VfdG9rZW49MjA=", "total": 100 } }
Contract address (empty for native assets)
- Mock server
https://docs.ripple.com/_mock/products/palisade/api-docs/palisade-api/palisade-api-1/v2/assets
- Sandbox server (uses TESTNET data, private keys and accounts)
https://api.sandbox.palisade.co/v2/assets
- Palisade server (uses MAINNET data, private keys and accounts)
https://api.palisade.co/v2/assets
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://docs.ripple.com/_mock/products/palisade/api-docs/palisade-api/palisade-api-1/v2/assets \
-H 'Authorization: YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json' \
-d '{
"blockchainId": "AVALANCHE",
"contractAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"symbol": "USDC",
"name": "USD Coin",
"decimals": 6,
"coingeckoId": "usd-coin",
"enabled": true
}'ID is unique across all blockchains and created by combining the blockchain ID, contract address, and symbol
The token contract address. This field will be empty if the asset is the native coin of the blockchain
The date and time the asset was created
The date and time the asset was last updated
CoinGecko identifier for price data (optional for testnet assets)
- ASSET_SOURCE_LEGACY: Legacy entries
- ASSET_SOURCE_AUTO: Auto-generated
- ASSET_SOURCE_COINGECKO: From CoinGecko sync
- ASSET_SOURCE_PALISADE: Admin entries
- ASSET_SOURCE_CUSTOMER: Customer entries
Any contains an arbitrary serialized protocol buffer message along with a URL that describes the type of the serialized message.
Protobuf library provides support to pack/unpack Any values in the form of utility functions or additional generated methods of the Any type.
Example 1: Pack and unpack a message in C++.
Foo foo = ...; Any any; any.PackFrom(foo); ... if (any.UnpackTo(&foo)) { ... }
Example 2: Pack and unpack a message in Java.
Foo foo = ...; Any any = Any.pack(foo); ... if (any.is(Foo.class)) { foo = any.unpack(Foo.class); } // or ... if (any.isSameTypeAs(Foo.getDefaultInstance())) { foo = any.unpack(Foo.getDefaultInstance()); }
Example 3: Pack and unpack a message in Python.
foo = Foo(...) any = Any() any.Pack(foo) ... if any.Is(Foo.DESCRIPTOR): any.Unpack(foo) ...
Example 4: Pack and unpack a message in Go
foo := &pb.Foo{...} any, err := anypb.New(foo) if err != nil { ... } ... foo := &pb.Foo{} if err := any.UnmarshalTo(foo); err != nil { ... }
The pack methods provided by protobuf library will by default use 'type.googleapis.com/full.type.name' as the type URL and the unpack methods only use the fully qualified type name after the last '/' in the type URL, for example "foo.bar.com/x/y.z" will yield type name "y.z".
JSON ==== The JSON representation of an Any value uses the regular representation of the deserialized, embedded message, with an additional field @type which contains the type URL. Example:
package google.profile; message Person { string first_name = 1; string last_name = 2; }
{ "@type": "type.googleapis.com/google.profile.Person", "firstName":
If the embedded message type is well-known and has a custom JSON representation, that representation will be embedded adding a field value which holds the custom JSON in addition to the @type field. Example (for message [google.protobuf.Duration][]):
{ "@type": "type.googleapis.com/google.protobuf.Duration", "value": "1.212s" }
When this asset was last synchronized
{ "id": "5:0xbehbehfb:USDC", "standard": "NATIVE", "symbol": "LINK", "name": "Chainlink", "blockchain": "AVALANCHE", "decimals": 18, "vetted": true, "enabled": true, "contract": "0x0b9d5D9136855f6FEc3c0993feE6E9CE8a297846e", "createdAt": "2022-03-29T10:22:22.420Z", "updatedAt": "2022-03-29T10:22:22.420Z", "organizationId": "string", "coingeckoId": "ethereum", "source": "ASSET_SOURCE_LEGACY", "sourceMetadata": { "@type": "string", "property1": null, "property2": null }, "lastSyncedAt": "2024-08-08T10:22:22.420Z", "syncVersion": 1, "contractAddressChecksummed": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48" }
- Mock server
https://docs.ripple.com/_mock/products/palisade/api-docs/palisade-api/palisade-api-1/v2/assets/{id}
- Sandbox server (uses TESTNET data, private keys and accounts)
https://api.sandbox.palisade.co/v2/assets/{id}
- Palisade server (uses MAINNET data, private keys and accounts)
https://api.palisade.co/v2/assets/{id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://docs.ripple.com/_mock/products/palisade/api-docs/palisade-api/palisade-api-1/v2/assets/{id}' \
-H 'Authorization: YOUR_API_KEY_HERE'ID is unique across all blockchains and created by combining the blockchain ID, contract address, and symbol
The token contract address. This field will be empty if the asset is the native coin of the blockchain
The date and time the asset was created
The date and time the asset was last updated
CoinGecko identifier for price data (optional for testnet assets)
- ASSET_SOURCE_LEGACY: Legacy entries
- ASSET_SOURCE_AUTO: Auto-generated
- ASSET_SOURCE_COINGECKO: From CoinGecko sync
- ASSET_SOURCE_PALISADE: Admin entries
- ASSET_SOURCE_CUSTOMER: Customer entries
Any contains an arbitrary serialized protocol buffer message along with a URL that describes the type of the serialized message.
Protobuf library provides support to pack/unpack Any values in the form of utility functions or additional generated methods of the Any type.
Example 1: Pack and unpack a message in C++.
Foo foo = ...; Any any; any.PackFrom(foo); ... if (any.UnpackTo(&foo)) { ... }
Example 2: Pack and unpack a message in Java.
Foo foo = ...; Any any = Any.pack(foo); ... if (any.is(Foo.class)) { foo = any.unpack(Foo.class); } // or ... if (any.isSameTypeAs(Foo.getDefaultInstance())) { foo = any.unpack(Foo.getDefaultInstance()); }
Example 3: Pack and unpack a message in Python.
foo = Foo(...) any = Any() any.Pack(foo) ... if any.Is(Foo.DESCRIPTOR): any.Unpack(foo) ...
Example 4: Pack and unpack a message in Go
foo := &pb.Foo{...} any, err := anypb.New(foo) if err != nil { ... } ... foo := &pb.Foo{} if err := any.UnmarshalTo(foo); err != nil { ... }
The pack methods provided by protobuf library will by default use 'type.googleapis.com/full.type.name' as the type URL and the unpack methods only use the fully qualified type name after the last '/' in the type URL, for example "foo.bar.com/x/y.z" will yield type name "y.z".
JSON ==== The JSON representation of an Any value uses the regular representation of the deserialized, embedded message, with an additional field @type which contains the type URL. Example:
package google.profile; message Person { string first_name = 1; string last_name = 2; }
{ "@type": "type.googleapis.com/google.profile.Person", "firstName":
If the embedded message type is well-known and has a custom JSON representation, that representation will be embedded adding a field value which holds the custom JSON in addition to the @type field. Example (for message [google.protobuf.Duration][]):
{ "@type": "type.googleapis.com/google.protobuf.Duration", "value": "1.212s" }
When this asset was last synchronized
{ "id": "5:0xbehbehfb:USDC", "standard": "NATIVE", "symbol": "LINK", "name": "Chainlink", "blockchain": "AVALANCHE", "decimals": 18, "vetted": true, "enabled": true, "contract": "0x0b9d5D9136855f6FEc3c0993feE6E9CE8a297846e", "createdAt": "2022-03-29T10:22:22.420Z", "updatedAt": "2022-03-29T10:22:22.420Z", "organizationId": "string", "coingeckoId": "ethereum", "source": "ASSET_SOURCE_LEGACY", "sourceMetadata": { "@type": "string", "property1": null, "property2": null }, "lastSyncedAt": "2024-08-08T10:22:22.420Z", "syncVersion": 1, "contractAddressChecksummed": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48" }