List Stablecoin Conversions

List all conversions, optionally filtering and paging the results.

By default, conversions are returned in reverse chronological (descending) order by creation time. If no query parameters are supplied, the response will include up to the last 100 conversions which were created.

The paginated results default to display up to 100 conversions, unless otherwise specified with the limit parameter. The maximum limit value is 1000. Every paginated response contains a next_page_cursor field until the last page is reached.

Pass the next_page_cursor value into the page_cursor field of a new request to retrieve the next page of results.

GET /conversion/stablecoins

Try it

List Stablecoin Conversions

cURL

curl --request GET \
  --url https://api.paxos.com/v2/conversion/stablecoins \
  --header 'Authorization: Bearer <token>'

200

{
  "items": [
    {
      "account_id": "00000000-0000-0000-0000-000000000000",
      "amount": "100.01",
      "created_at": "2023-09-16T02:01:15.941902Z",
      "id": "38a2c6b4-167c-4c98-a190-406efc4121aa",
      "identity_id": "00000000-0000-0000-0000-000000000000",
      "metadata": {
        "skey": "svalue"
      },
      "profile_id": "b821ff88-fdb4-49ba-b30f-99c40f01fcfc",
      "ref_id": "497266c5214043a29f9854096e9a9103",
      "settled_at": "2023-09-16T02:01:16.613995Z",
      "source_asset": "USD",
      "status": "SETTLED",
      "target_asset": "USDP",
      "updated_at": "2023-09-16T02:01:16.018493Z"
    },
    {
      "account_id": "00000000-0000-0000-0000-000000000000",
      "amount": "100.01",
      "created_at": "2023-09-16T03:34:50.555200Z",
      "id": "a490536f-3842-4823-8c84-056728243064",
      "identity_id": "00000000-0000-0000-0000-000000000000",
      "metadata": {
        "skey": "svalue"
      },
      "profile_id": "b821ff88-fdb4-49ba-b30f-99c40f01fcfc",
      "ref_id": "4fecc881b73744e4a4e858017689da7d",
      "settled_at": "2023-09-16T03:34:51.060002Z",
      "source_asset": "USD",
      "status": "SETTLED",
      "target_asset": "USDP",
      "updated_at": "2023-09-16T03:34:50.610541Z"
    }
  ]
}

OAuth Scope

conversion:read_conversion_stablecoin

Authorizations

Authorization · string · header · required

Paxos APIs use OAuth 2 with the client credentials grant flow.

Token URLs:

• Production: https://oauth.paxos.com/oauth2/token
• Sandbox: https://oauth.sandbox.paxos.com/oauth2/token

Learn more in the API credentials guide →

Query Parameters

profile_id · string

The Profile associated with a conversion. Required in the Create Stablecoin Conversion request.

ref_id · string

Client provided, unique Reference ID included the Create Stablecoin Conversion request.

created_at.begin · string<date-time>

Only return records after this timestamp, inclusive. RFC3339 format, like 2006-01-02T15:04:05Z.

created_at.end · string<date-time>

Only return records before this timestamp, inclusive. RFC3339 format, like 2006-01-02T15:04:05Z.

updated_at.begin · string<date-time>

Only return records after this timestamp, inclusive. RFC3339 format, like 2006-01-02T15:04:05Z.

updated_at.end · string<date-time>

Only return records before this timestamp, inclusive. RFC3339 format, like 2006-01-02T15:04:05Z.

order · enum<string>

Return items in ascending (ASC) or descending (DESC) order by created_at timestamp.

Default order is descending (DESC).

Available options: DESC, ASC

page_cursor · string

Cursor token for fetching the next page.

limit · integer<int32>

Number of results to return.

Default is 100 items. Maximum is 1000 items.

Response

200

application/json

A successful response.

items · object[]

Show child attributes

items. id · string

System provided UUID for the conversion is provided in the Create Stablecoin Conversion response.

Required parameter for the Get Stablecoin Conversion request.

items. profile_id · string

The Profile associated with a conversion. Required in the Create Stablecoin Conversion request.

items. amount · string

Asset amount to convert. Details.

items. source_asset · string

The asset to convert from. Details.

items. target_asset · string

The asset to convert to. Details.

items. status · string

The current status of the conversion. Details.

items. ref_id · string

Client provided, unique Reference ID included the Create Stablecoin Conversion request.

items. identity_id · string

The Identity ID associated with the user requesting the conversion. Required only for customers with 3rd-Party integrations.

items. account_id · string

The Account ID associated with the user requesting the conversion. Required only for customers with 3rd-Party integrations.

items. created_at · string<date-time>

The time at which the conversion was requested. See RFC3339 format, like 2006-01-02T15:04:05Z.

items. updated_at · string<date-time>

The time at which the conversion was last updated. RFC3339 format, like 2006-01-02T15:04:05Z.

items. settled_at · string<date-time>

The time at which the conversion was settled. Details. RFC3339 format, like 2006-01-02T15:04:05Z.

items. cancelled_at · string<date-time>

The time at which the conversion has been cancelled. Details. RFC3339 format, like 2006-01-02T15:04:05Z.

items. metadata · object

Optional client-specified stored metadata.

Show child attributes

items.metadata. {key} · string

items. recipient_profile_id · string

For directed settlement, the receiving side profile_id.

next_page_cursor · string

Cursor token required for fetching the next page.