---
title: "List crypto instructions"
method: GET
path: "/v1/stablecoin/crypto-instructions"
tags: ["Crypto instructions"]
---

# List crypto instructions

`GET /v1/stablecoin/crypto-instructions`

## Request

- Base URL: `https://api.ripple.com`
- URL: `https://api.ripple.com/v1/stablecoin/crypto-instructions`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.ripple.com/v2/oauth/token` scopes: `rlusd_customers:read`
- TypeScript: <https://skmtc.dev/ripple/apis/ripple-mint-api/docs/v1/stablecoin/crypto-instructions/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the distinct Ripple-owned on-chain destinations to which the authenticated tenant
sends RLUSD for redemption/bridging. An empty or cold cache returns an empty page with `200 OK`.

## Query parameters

- `page` integer
- `size` integer
- `sort` string

## Response `200`

Paginated list of distinct redemption destinations

- CryptoInstructionListResponse
  - `content` CryptoInstruction[]
    - `counterpartyAddress` string, required: Ripple-owned address to which RLUSD is sent for redemption/bridging. EVM addresses include the `0x` prefix; XRPL and Solana addresses are unchanged.
    - `chain` string, required: Blockchain network name.
  - `totalElements` integer: Total number of distinct redemption destinations
  - `totalPages` integer
  - `size` integer
  - `number` integer: Current page number (0-indexed)

## Other responses

- `401`: Missing or expired access token
- `403`: The caller is not entitled to the operation - either the access token lacks the scope the operation requires, or the tenant is not entitled to the API at all (`FORBIDDEN`).
- `500`: Unexpected server error

## Changes

- **2026-09-18** `6db752579872`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ripple/apis/ripple-mint-api/changes/v1/stablecoin/crypto-instructions/get.md)

---

[API](https://skmtc.dev/ripple/apis/ripple-mint-api.md) - [All operations](https://skmtc.dev/ripple/apis/ripple-mint-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ripple/apis/ripple-mint-api/revisions/6db752579872?raw)