Get Trade URLs

A trade URL contains a WAX ExpressTrade uid (e.g., 6434082) and unique token (e.g., RTukQC3l - not to be confused with an OAuth bearer token), which enables P2P trading between WAX ExpressTrade users. Trade URLs are available from the WAX ExpressTrade > Settings page.

Short URL

https://trade.wax-sandbox.com/t/6434082/RTukQC3l

You’ll need to have a user’s trade URL to use the SendOffer endpoint.

If you’re not using WAX All Access to authenticate users, you can simply prompt users to input their trade URL from your app or another front-end service.

Use the API

The WAX ExpressTrade GetTradeURL endpoint returns a user id, trade token, and a short and long version of a user’s trade URL.

Authorization

Type Example Description
API Key -H "X-API-Key: 999d9ab99cde999a99cb9999df9999" Required (in header). Use this to get your trade URL.
Bearer -H 'Authorization: Bearer 452589dfgghhjjkl4885521236985' Required. Use this to get a user's trade URL.
OAuth Scopes: identity_basic, identity, trades

URLs

Environment URL
Sandbox https://api-trade.wax-sandbox.com/ITrade/GetTradeURL/v1/
Production https://api-trade.wax.io/ITrade/GetTradeURL/v1/

Get Your Trade URLs


curl -X GET \
  https://api-trade.wax-sandbox.com/ITrade/GetTradeURL/v1/ \
  -H "X-API-Key: 999d9ab99cde999a99cb9999df9999" \
  -H 'cache-control: no-cache' 

Get a User’s Trade URLs

If you’d like to use WAX All Access to authenticate users, refer to OAuth Quickstart for more information.

Note: To use the WAX ExpressTrade OAuth endpoints, you might want to consider the following OAuth Scopes: identity, trades, trades_no_2fa. Once you have a bearer token, you can also Get User Profiles and Get User Trade Inventory.

curl -X GET \
  https://api-trade.wax-sandbox.com/ITrade/GetTradeURL/v1/ \
  -H 'Authorization: Bearer 452589dfgghhjjkl4885521236985' \
  -H 'cache-control: no-cache' 

Response


{
    "status": 1,
    "time": 1567527210,
    "response": {
        "uid": 6743505,
        "token": "F4QGmzep",
        "short_url": "https://trade.wax-sandbox.com/t/6743505/F4QGmzep",
        "long_url": "https://trade.wax-sandbox.com/trade/userid/6743505/token/F4QGmzep"
    }
}

What's Next