The RippleNet Server API provides you the ability to develop custom applications to manage or interact with your RippleNet instance.
Check out the best practices and tutorials.
The RippleNet Server API provides you the ability to develop custom applications to manage or interact with your RippleNet instance.
Check out the best practices and tutorials.
All API operations require a bearer access token for your target environment.<br>Learn how to request the access token.
The RippleNet Server API creates a dynamic [domainPrefix] that consists of {tenant}.{environment}.
Note: This example uses aperture as the tenant. Your tenant ID is different.
| Environment | Domaing Prefix | Domain | Base URL |
|---|---|---|---|
| Test | aperture.test | ripplexcurrent.com | https://aperture.test.ripplexcurrent.com |
| UAT | aperture.uat | ripplexcurrent.com | https://aperture.uat.ripplexcurrent.com |
| Production | aperture.prod | ripplexcurrent.com | https://aperture.prod.ripplexcurrent.com |
https://docs.ripple.com/_mock/products/payments-odl/api-docs/ripplenet/ripplenet/
https://[domainPrefix].ripplexcurrent.com/v4/
The page number for paginated results. The value is zero-based, where 0 represents the first page.<br/> Set it to 0 to get the first page of results.
Returns transfers that contain any of the specified labels.<p>Example - ?with_labels=LABEL1,LABEL2</p>
Returns labels added to each Transfer object. By default labels are not returned. <p>Example - ?with_labels=LABEL1&include_labels=true</p>
https://docs.ripple.com/_mock/products/payments-odl/api-docs/ripplenet/ripplenet/transfers
https://[domainPrefix].ripplexcurrent.com/v4/transfers
curl -i -X GET \
'https://docs.ripple.com/_mock/products/payments-odl/api-docs/ripplenet/ripplenet/transfers?page=0&size=20&with_labels=string&without_labels=string&include_labels=false&state=PREPARED&internal_id=string&sender_end_to_end_id=string&sort_field=CREATED_AT&sort_direction=ASC&account=string&transfer_account_role=SENDING' \
-H 'Authorization: YOUR_API_KEY_HERE'Successfully returned transfers.
Sort details of this page
Provides an array of transfer objects.
Unique identifier of the transfer.
State of the transfer.<p>QUOTED and PENDING only apply when RippleNet is enabled to receive payments from xRapid. QUOTED represents an outbound transfer fee estimate. PENDING is the state of an outbound transfer executed by RippleNet (via xRapid) but not yet paid out by the digital exchange. If successfully paid out, the state becomes COMPLETED. If not successfully paid out by the digital exchange, the state becomes FAILED. </p>
Owner RippleNet address, if different from the RippleNet address of the sender_address and receiver_address.
RippleNet account name and address, in the format accountname@ripplenetaddress. For example, new_york@rn.us.ny.new_york.
RippleNet account name and address, in the format accountname@ripplenetaddress. For example, new_york@rn.us.ny.new_york.
Internal ID that the sender can optionally specify. Only visible to the sender. Only the sending RippleNet instance stores this ID.
ID that the sender can optionally specify. Persisted on all RippleNet instances that participated in the transfer.
Optional sending fee charged by a digital asset exchange for initiating an outbound transfer.
The time when this transfer is created.
Custom information set by a RippleNet address involved in the transfer.
RippleNet address of the xCurrent instance that set the user information.
State of the transfer set when the RippleNet address set the user information.
{ "first": true, "last": true, "number": 0, "numberOfElements": 0, "size": 0, "totalElements": 0, "totalPages": 0, "sort": [ { … } ], "content": [ { … } ] }
https://docs.ripple.com/_mock/products/payments-odl/api-docs/ripplenet/ripplenet/transfers/estimate
https://[domainPrefix].ripplexcurrent.com/v4/transfers/estimate
curl -i -X GET \
'https://docs.ripple.com/_mock/products/payments-odl/api-docs/ripplenet/ripplenet/transfers/estimate?sender_address=string&receiver_address=string&amount=0' \
-H 'Authorization: YOUR_API_KEY_HERE'Successfully retrieved estimate of transfer sending fee
Unique identifier of the transfer.
State of the transfer.<p>QUOTED and PENDING only apply when RippleNet is enabled to receive payments from xRapid. QUOTED represents an outbound transfer fee estimate. PENDING is the state of an outbound transfer executed by RippleNet (via xRapid) but not yet paid out by the digital exchange. If successfully paid out, the state becomes COMPLETED. If not successfully paid out by the digital exchange, the state becomes FAILED. </p>
Owner RippleNet address, if different from the RippleNet address of the sender_address and receiver_address.
RippleNet account name and address, in the format accountname@ripplenetaddress. For example, new_york@rn.us.ny.new_york.
RippleNet account name and address, in the format accountname@ripplenetaddress. For example, new_york@rn.us.ny.new_york.
Internal ID that the sender can optionally specify. Only visible to the sender. Only the sending RippleNet instance stores this ID.
ID that the sender can optionally specify. Persisted on all RippleNet instances that participated in the transfer.
Optional sending fee charged by a digital asset exchange for initiating an outbound transfer.
The time when this transfer is created.
Custom information set by a RippleNet address involved in the transfer.
RippleNet address of the xCurrent instance that set the user information.
State of the transfer set when the RippleNet address set the user information.
{ "transfer_id": "9eca588f-e89d-4629-82fa-da9c4646310f", "state": "EXECUTED", "owner_address": "rn.us.ca.san_francisco", "sender_address": "trans_usd_sf@rn.us.ca.san_francisco", "receiver_address": "conct_usd_sf@rn.us.ca.san_francisco", "amount": 15, "internal_id": "9cf5aa4b-1e44-436a-ab7c-d399aec905da", "end_to_end_id": "fd7559be-aa85-433f-a283-0cd58681cdf0", "sending_fee": 0, "created_at": "2019-10-01T21:28:28.354Z", "user_info": [ { … } ], "labels": [ "label1", "label2", "label3" ] }
https://docs.ripple.com/_mock/products/payments-odl/api-docs/ripplenet/ripplenet/transfers/{transfer_id}
https://[domainPrefix].ripplexcurrent.com/v4/transfers/{transfer_id}
curl -i -X GET \
'https://docs.ripple.com/_mock/products/payments-odl/api-docs/ripplenet/ripplenet/transfers/{transfer_id}?include_labels=false' \
-H 'Authorization: YOUR_API_KEY_HERE'Successfully retrieved transfer.
Unique identifier of the transfer.
State of the transfer.<p>QUOTED and PENDING only apply when RippleNet is enabled to receive payments from xRapid. QUOTED represents an outbound transfer fee estimate. PENDING is the state of an outbound transfer executed by RippleNet (via xRapid) but not yet paid out by the digital exchange. If successfully paid out, the state becomes COMPLETED. If not successfully paid out by the digital exchange, the state becomes FAILED. </p>
Owner RippleNet address, if different from the RippleNet address of the sender_address and receiver_address.
RippleNet account name and address, in the format accountname@ripplenetaddress. For example, new_york@rn.us.ny.new_york.
RippleNet account name and address, in the format accountname@ripplenetaddress. For example, new_york@rn.us.ny.new_york.
Internal ID that the sender can optionally specify. Only visible to the sender. Only the sending RippleNet instance stores this ID.
ID that the sender can optionally specify. Persisted on all RippleNet instances that participated in the transfer.
Optional sending fee charged by a digital asset exchange for initiating an outbound transfer.
The time when this transfer is created.
Custom information set by a RippleNet address involved in the transfer.
RippleNet address of the xCurrent instance that set the user information.
State of the transfer set when the RippleNet address set the user information.
{ "transfer_id": "9eca588f-e89d-4629-82fa-da9c4646310f", "state": "EXECUTED", "owner_address": "rn.us.ca.san_francisco", "sender_address": "trans_usd_sf@rn.us.ca.san_francisco", "receiver_address": "conct_usd_sf@rn.us.ca.san_francisco", "amount": 15, "internal_id": "9cf5aa4b-1e44-436a-ab7c-d399aec905da", "end_to_end_id": "fd7559be-aa85-433f-a283-0cd58681cdf0", "sending_fee": 0, "created_at": "2019-10-01T21:28:28.354Z", "user_info": [ { … } ], "labels": [ "label1", "label2", "label3" ] }
Transfers funds between accounts. For example, use this request to fund a connector account by transferring funds from a transactional account to the connector account. You can also use this request to redeem funds to a transactional account by transferring funds from a connector account to the transactional account.
See Transfer Request Object.
RippleNet account name and address, in the format accountname@ripplenetaddress. For example, new_york@rn.us.ny.new_york.
RippleNet account name and address, in the format accountname@ripplenetaddress. For example, new_york@rn.us.ny.new_york.
Owner RippleNet address, if different from the RippleNet address of the sender_address and receiver_address.
ID set by the sender that is persisted on all xCurrent instances that participated in the transfer.
ID set by the sender that is persisted on the sending xCurrent instance only.
https://docs.ripple.com/_mock/products/payments-odl/api-docs/ripplenet/ripplenet/transfers/execute
https://[domainPrefix].ripplexcurrent.com/v4/transfers/execute
curl -i -X POST \
https://docs.ripple.com/_mock/products/payments-odl/api-docs/ripplenet/ripplenet/transfers/execute \
-H 'Authorization: YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json' \
-d '{
"sender_address": "trans_usd_sf@rn.us.ca.san_francisco",
"receiver_address": "conct_usd_sf@rn.us.ca.san_francisco",
"amount": 15,
"owner_address": "rn.us.ca.san_francisco",
"end_to_end_id": "b09dd632-660e-48c8-907f-a4f3a7d12c18",
"internal_id": "9ad3c119-1379-443b-9c0e-fa82c54ae78d",
"user_info": {}
}'Successfully executed transfer.
Unique identifier of the transfer.
State of the transfer.<p>QUOTED and PENDING only apply when RippleNet is enabled to receive payments from xRapid. QUOTED represents an outbound transfer fee estimate. PENDING is the state of an outbound transfer executed by RippleNet (via xRapid) but not yet paid out by the digital exchange. If successfully paid out, the state becomes COMPLETED. If not successfully paid out by the digital exchange, the state becomes FAILED. </p>
Owner RippleNet address, if different from the RippleNet address of the sender_address and receiver_address.
RippleNet account name and address, in the format accountname@ripplenetaddress. For example, new_york@rn.us.ny.new_york.
RippleNet account name and address, in the format accountname@ripplenetaddress. For example, new_york@rn.us.ny.new_york.
Internal ID that the sender can optionally specify. Only visible to the sender. Only the sending RippleNet instance stores this ID.
ID that the sender can optionally specify. Persisted on all RippleNet instances that participated in the transfer.
Optional sending fee charged by a digital asset exchange for initiating an outbound transfer.
The time when this transfer is created.
Custom information set by a RippleNet address involved in the transfer.
RippleNet address of the xCurrent instance that set the user information.
State of the transfer set when the RippleNet address set the user information.
{ "transfer_id": "9eca588f-e89d-4629-82fa-da9c4646310f", "state": "EXECUTED", "owner_address": "rn.us.ca.san_francisco", "sender_address": "trans_usd_sf@rn.us.ca.san_francisco", "receiver_address": "conct_usd_sf@rn.us.ca.san_francisco", "amount": 15, "internal_id": "9cf5aa4b-1e44-436a-ab7c-d399aec905da", "end_to_end_id": "fd7559be-aa85-433f-a283-0cd58681cdf0", "sending_fee": 0, "created_at": "2019-10-01T21:28:28.354Z", "user_info": [ { … } ], "labels": [ "label1", "label2", "label3" ] }
https://docs.ripple.com/_mock/products/payments-odl/api-docs/ripplenet/ripplenet/transfers/{transfer_id}/complete
https://[domainPrefix].ripplexcurrent.com/v4/transfers/{transfer_id}/complete
curl -i -X POST \
'https://docs.ripple.com/_mock/products/payments-odl/api-docs/ripplenet/ripplenet/transfers/{transfer_id}/complete' \
-H 'Authorization: YOUR_API_KEY_HERE'Successfully completed transfer.
Unique identifier of the transfer.
State of the transfer.<p>QUOTED and PENDING only apply when RippleNet is enabled to receive payments from xRapid. QUOTED represents an outbound transfer fee estimate. PENDING is the state of an outbound transfer executed by RippleNet (via xRapid) but not yet paid out by the digital exchange. If successfully paid out, the state becomes COMPLETED. If not successfully paid out by the digital exchange, the state becomes FAILED. </p>
Owner RippleNet address, if different from the RippleNet address of the sender_address and receiver_address.
RippleNet account name and address, in the format accountname@ripplenetaddress. For example, new_york@rn.us.ny.new_york.
RippleNet account name and address, in the format accountname@ripplenetaddress. For example, new_york@rn.us.ny.new_york.
Internal ID that the sender can optionally specify. Only visible to the sender. Only the sending RippleNet instance stores this ID.
ID that the sender can optionally specify. Persisted on all RippleNet instances that participated in the transfer.
Optional sending fee charged by a digital asset exchange for initiating an outbound transfer.
The time when this transfer is created.
Custom information set by a RippleNet address involved in the transfer.
RippleNet address of the xCurrent instance that set the user information.
State of the transfer set when the RippleNet address set the user information.
{ "transfer_id": "9eca588f-e89d-4629-82fa-da9c4646310f", "state": "EXECUTED", "owner_address": "rn.us.ca.san_francisco", "sender_address": "trans_usd_sf@rn.us.ca.san_francisco", "receiver_address": "conct_usd_sf@rn.us.ca.san_francisco", "amount": 15, "internal_id": "9cf5aa4b-1e44-436a-ab7c-d399aec905da", "end_to_end_id": "fd7559be-aa85-433f-a283-0cd58681cdf0", "sending_fee": 0, "created_at": "2019-10-01T21:28:28.354Z", "user_info": [ { … } ], "labels": [ "label1", "label2", "label3" ] }
https://docs.ripple.com/_mock/products/payments-odl/api-docs/ripplenet/ripplenet/transfers/{transfer_id}/labels
https://[domainPrefix].ripplexcurrent.com/v4/transfers/{transfer_id}/labels
curl -i -X PUT \
'https://docs.ripple.com/_mock/products/payments-odl/api-docs/ripplenet/ripplenet/transfers/{transfer_id}/labels?label=string' \
-H 'Authorization: YOUR_API_KEY_HERE'https://docs.ripple.com/_mock/products/payments-odl/api-docs/ripplenet/ripplenet/transfers/{transfer_id}/labels
https://[domainPrefix].ripplexcurrent.com/v4/transfers/{transfer_id}/labels
curl -i -X DELETE \
'https://docs.ripple.com/_mock/products/payments-odl/api-docs/ripplenet/ripplenet/transfers/{transfer_id}/labels?label=string' \
-H 'Authorization: YOUR_API_KEY_HERE'https://docs.ripple.com/_mock/products/payments-odl/api-docs/ripplenet/ripplenet/v4/orchestration/info
https://[domainPrefix].ripplexcurrent.com/v4/v4/orchestration/info
curl -i -X GET \
https://docs.ripple.com/_mock/products/payments-odl/api-docs/ripplenet/ripplenet/v4/orchestration/info \
-H 'Authorization: YOUR_API_KEY_HERE'{ "name": "Integration Module", "version": "1.2.0" }