Transactions

The /v1/account/transactions endpoint retrieves a paginated list of user account transactions, including details such as transaction type, status, amount, fees, and associated items.

HTTP Request

GET /v1/account/transactions

Authorization

Required, see Authentication.

Arguments

Parameter	Type	Required	Description
page	number	Optional	Pagination Page (default 1).
limit	number	Optional	Limit results between 1 and 100 (default 100).
order	string	Optional	Order results by asc or desc (default desc).

Transaction Types

Type	Account	Description
purchase	Buyer	An order you paid.
credit	Seller	An item you sold: amount is the sale price, fee the commission.
withdraw	Seller	A payout to your bank account.
refund	Buyer	The price of a sold item refunded to you, e.g. because the seller reversed the Steam trade.
reversal	Seller	The credit of a sale that was refunded to the buyer, taken back from you.

All amounts, fees and taxes are positive values, the type tells the direction.

info

A refund doesn't change the original purchase or credit, they stay complete. A refunded sale has an additional refund (buyer) or reversal (seller) with the same sale_id in its items.

The status of a refund is pending until it is approved, refunding while the payment provider processes it and complete once the money is on its way back to you.

Example Request

JavaScript

transactions.mjs

const params = new URLSearchParams({
  page: 1,
  limit: 100,
  order: 'desc',
});

const response = await fetch(`https://api.skinport.com/v1/account/transactions?${params}`, {
  headers: {
    Authorization: 'Basic <Base64_Encoded_String>',
    'Accept-Encoding': 'br',
  },
});

const data = await response.json();
console.log(data);

Python

transactions.py

# pip install requests brotli  # brotli is needed to decode 'br' responses
import requests

params = {
    'page': 1,
    'limit': 100,
    'order': 'desc',
}

response = requests.get(
    'https://api.skinport.com/v1/account/transactions',
    params=params,
    auth=('MY_CLIENT_ID', 'MY_CLIENT_SECRET'),  # requests builds the Basic header
    headers={'Accept-Encoding': 'br'},
)

data = response.json()
print(data)

cURL

curl --compressed -u 'MY_CLIENT_ID:MY_CLIENT_SECRET' -H 'Accept-Encoding: br' \
  'https://api.skinport.com/v1/account/transactions?page=1&limit=100&order=desc'

Example Response

console.log(data)

{
    "pagination": {
        "page": 1,
        "pages": 1,
        "limit": 100,
        "order": "desc"
    },
    "data": [
        {
            "id": 9999993,
            "type": "credit",
            "sub_type": "item",
            "status": "complete",
            "amount": 1.57,
            "fee": 0.09,
            "currency": "EUR",
            "items": [
                {
                    "sale_id": 9999321,
                    "market_hash_name": "Mann Co. Supply Crate Key",
                    "seller_country": "DE",
                    "buyer_country": "DE",
                    "asset_id": 12345678,
                    "wear": null,
                    "pattern": null,
                    "finish": null,
                    "amount": 1.57,
                    "currency": "EUR"
                }
            ],
            "created_at": "2021-10-11T21:22:24.425Z",
            "updated_at": "2021-10-11T21:22:24.425Z"
        },
        {
            "id": 9999992,
            "type": "withdraw",
            "sub_type": null,
            "status": "complete",
            "amount": 1333.70,
            "fee": null,
            "currency": "EUR",
            "items": null,
            "created_at": "2021-10-11T05:30:10.880Z",
            "updated_at": "2021-10-11T06:14:07.427Z"
        },
        {
            "id": 9999991,
            "type": "purchase",
            "sub_type": null,
            "status": "complete",
            "amount": 90.01,
            "fee": null,
            "currency": "EUR",
            "items": [
                {
                    "sale_id": 9999123,
                    "market_hash_name": "★ Huntsman Knife | Fade (Factory New)",
                    "seller_country": "US",
                    "buyer_country": "DE",
                    "asset_id": 12345678,
                    "wear": 0.00123456,
                    "pattern": 666,
                    "finish": 123,
                    "amount": 90.01,
                    "currency": "EUR"
                }
            ],
            "created_at": "2021-08-27T03:00:34.728Z",
            "updated_at": "2021-08-27T03:00:58.488Z"
        }
    ]
}