{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/payments-odl/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Exchange credentials","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com/products/custody","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"exchange-credentials","__idx":0},"children":["Exchange credentials"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Exchange Credentials settings page lists the Digital Asset Exchanges (DAXs) to which your institution is currently connected, along with additional DAXs that are available to connect."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/connections-page.3d5b1cbde170dc3b7a1f4e239a11e56f0c694aca31a9a14f210e0ecfb8ee95a6.6ae46ae6.png","alt":"Connections page"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Status"]}," tab will display the status of your connection to RippleNet, along with the network status of each connected partner."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/connections-status.98386b082f75d5d64f64cfa5c74a382a5aef1eb8fd3a7cada638d94eee7c9ca5.6ae46ae6.png","alt":"Status tab"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"available-exchanges","__idx":1},"children":["Available exchanges"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To view the details of an available exchange, click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Details"]}," button in the associated card for the exchange."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/connections-dax-details-card.667ef3756f26c568ae637579596c9520bd3889a24af40df70a967e472951ee2e.6ae46ae6.png","alt":"Exchange details button"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This displays the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Exchange details"]}," page."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/connections-dax-details.620114d2ec3220f5401f50d47a5b6ca7f6ed06d909e57e3ea03c70f5f6fba884.6ae46ae6.png","alt":"Exchange details button"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Exchange details page provides:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["General information about the exchange: location, URL, telephone number, and email address"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["List of supported currencies"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Contact information"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Button to download the exchange onboarding process document"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"add-exchange-credentials","__idx":2},"children":["Add exchange credentials"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To add exchange credentials to your RippleNet account, select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add Credentials"]}," card on the Connections page."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add Credentials"]}," card isn't visible, check if you have the correct user permissions by selecting ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]}," > ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Users"]},". If you're already an admin user or your user has been granted read and edit permissions for ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Exchanges"]},", but you can't see the card, contact your Ripple liaison to enable the feature.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"For more information on user permissions, see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/payments-odl/user-interface/users#permissions"},"children":["User management"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/connections-add-credentials.b8ee2e4e3f7e80841c13f3cf913f4c5944de286138cfcb96c81aee4e2aa12ec9.6ae46ae6.png","alt":"Add Credentials card"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This displays the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add Exchange Credentials"]}," page."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/connections-add-credentials-page.4f36d418c7e340760922b52e7841d16c6056f47f715864972a230c7fcd4d268a.6ae46ae6.png","alt":"Add Exchange Credentials page"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add Exchange Credentials"]}," form contains a number of required fields to connect the exchange with your RippleNet account:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Exchange"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The name of the Digital Asset Exchange you are connecting with."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Environment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The RippleNet environment associated with the exchange."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Account Name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The name of your account with the exchange.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," Your account name should be the same as your Customer ID at the exchange."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Secret"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The API secret is used for authentication and represents your exchange account password."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Key"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The API key represents your exchange account user ID for authenticating API calls."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"edit-exchange-credentials","__idx":3},"children":["Edit exchange credentials"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To edit exchange credentials, click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit"]}," button on a connected exchange card."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/connections-dax-card.df725a38f38b7a834955b7d7180ebdae054a734cb5fb76289dc5cb1ca352407c.6ae46ae6.png","alt":"Edit Exchange Credentials button"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This displays the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit Exchange Credentials"]}," page."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/connections-edit-exchange-credentials.491140c1f626a8a24fb3551532e5542a5a32bcb690f17f99543d565921681b34.6ae46ae6.png","alt":"Edit Exchange Credentials page"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The fields on the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit Exchange Credentials"]}," form are identical to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add Exchange Credentials"]}," form."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Exchange"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The name of the Digital Asset Exchange you are connecting with."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Environment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The RippleNet environment associated with the exchange."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Account Name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The name of your account with the exchange.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," Your account name should be the same as your Customer ID at the exchange."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Secret"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The API secret is used for authentication and represents your exchange account password."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Key"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The API key represents your exchange account user ID for authenticating API calls."]}]}]}]}]}]},"headings":[{"value":"Exchange credentials","id":"exchange-credentials","depth":1},{"value":"Available exchanges","id":"available-exchanges","depth":2},{"value":"Add exchange credentials","id":"add-exchange-credentials","depth":2},{"value":"Edit exchange credentials","id":"edit-exchange-credentials","depth":2}],"frontmatter":{"seo":{"title":"Exchange credentials"}},"lastModified":"2026-02-25T02:14:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/payments-odl/user-interface/settings/exchange-credentials","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}