Returns a single on ramp order executed by the user

GET /orders/{orderId}

Returns a single on ramp order executed by the user

Path parameters

  • orderId string Required

    single order ID

Query parameters

  • walletAddress string Required

    The wallet address supposedly associated with the order. This is used as a security measure preventing random order browsing.

Responses

  • 200 application/json

    Successful operation

    Hide response attributes Show response attributes object
    • id string
    • customId string

      If the "order custom ID" is enabled in the /configuration endpoint, an ID provided by StablyRamp allowing to retrieve the order.

    • userId string
    • crypto object
      Hide crypto attributes Show crypto attributes object
      • id string
      • address string
      • network string
    • fiatAmountInUsd string
    • fiat string

      The ISO 4217 code of the fiat currency used to pay for the order.

    • payment string

      The payment method used to buy the crypto. The ID defined in the configuration.

    • providerPayment string

      A provider-defined payment method, providing more details than the payment field. For example, if a VISA credit card was used with with the "debit-credit-card" payment method, this field may contain "VISA".

    • cryptoAmountOut string
    • fiatAmountIn string
    • exchangeRate string

      The exchange rate used to get the amount of crypto

    • processingFees array[object]
      Hide processingFees attributes Show processingFees attributes object
      • label string
      • fiatAmount: string

        Amount of the fee taken, as an amount of the order fiat currency

    • networkFees array[object]
      Hide networkFees attributes Show networkFees attributes object
      • label string
      • fiatAmount: string

        Amount of the fee taken, as an amount of the order fiat currency

    • partnerFees array[object]
      Hide partnerFees attributes Show partnerFees attributes object
      • label string
      • fiatAmount: string

        Amount of the fee taken, as an amount of the order fiat currency

    • createdAt string
    • updatedAt string
    • transactionHash string

      The hash of the transaction transfering the crypto to the user wallet. Depending on Stably Ramp behavior, transfers could be bundled and a single transaction could be linked to multiple orders.

    • walletAddress string

      The wallet address of the user. When the order is completed, crypto funds are sent to this address.

    • status string

      The status of the order. Pending orders are periodically polled by StablyRamp. Completed, failed or cancelled orders are never polled again once StablyRamp detects one of these statuses

      Values are PENDING, COMPLETED, FAILED, or CANCELLED.

    • statusCode string

      If applicable, a code defined by Stably Ramp, providing more details than the StablyRamp-defined status field.

    • statusReason string

      If applicable, information explaining how the order has its current status.

    • partnerAccountId string

      An value identifying Consensys/StablyRamp as the partner associated with the transaction

    • orderType string

      The type of the order. "BUY" for a buy order, "SELL" for a sell order.

      Values are BUY or SELL.

  • 500 application/json

    An unexpected error

    Hide response attributes Show response attributes object
    • error string

      A description of the unexpected error.

    • code integer

      The error code associated with the unexpected error.

    • message string

      A detailed error message explaining the issue.

GET /orders/{orderId}
curl \
 -X GET https://ramp-api.dev.stably.io/public/api/v1/orders/{orderId}?walletAddress=string
Response examples (200)
{
  "id": "cd7ad58d",
  "customId": "p2nf67p1312nffgmubisg77ego4hrhx6lrxh21hd3e558qxsx57g9j5p0u7nl7hz",
  "userId": "user-52324447448",
  "link": "https://www.crypto-provider-example.com/order/cd7ad58d-0fbb-4ed5-9fdd-832c1709ce85",
  "crypto": {
    "id": "eth",
    "address": "0x000000000",
    "network": "ethereum"
  },
  "fiatAmountInUsd": "100",
  "fiat": "USD",
  "payment": "debit-credit-card",
  "providerPayment": "Visa",
  "cryptoAmountOut": "0.0001",
  "fiatAmountIn": "100",
  "exchangeRate": "0.0001",
  "processingFees": [
    {
      "label": "fee label",
      "fiatAmount:": "10"
    }
  ],
  "networkFees": [
    {
      "label": "fee label",
      "fiatAmount:": "10"
    }
  ],
  "partnerFees": [
    {
      "label": "fee label",
      "fiatAmount:": "10"
    }
  ],
  "createdAt": "2021-01-01T00:00:00Z",
  "updatedAt": "2021-01-01T00:00:00Z",
  "transactionHash": "0x000000000",
  "walletAddress": "0x000000000",
  "status": "PENDING",
  "statusCode": "PROVIDER-PENDING-ORDER",
  "statusReason": "The order is currently being processed.",
  "partnerAccountId": "StablyRamp",
  "orderType": "BUY"
}
Response examples (500)
{
  "error": "string",
  "code": 42,
  "message": "string"
}