Trades History API

  1. Visit https://paxful.com/data/trades — this displays all successfully completed trades.
  2. To receive the set of correct trades, provide query parameter names/filters within the URL.
  3. Do not request more than 100 trades in your request.There is a hard cap of 100 trades per request. If you request more than 100 trades, you will only receive the first 100. Refer to the “Filters Table” below for parameter names.
  4. Trades completed within the last 24 hours are never included in the list of trades. This is because cancelled trades can still be re-opened within 24 hours. All trades that are completed within the last 24 hours will be placed under completed trades. This helps ensure your request will never miss a completed trade.
  5. To gather specific currency trade history list(s), append the URL to any fiat currency code. For example: https://paxful.com/data/trades/USD or https://paxful.com/data/trades/EUR

Available filters

This table gives you parameter names to help you find a more specific trade history list.
Query Parameter Name/Filter NameDescription
sincetype
  • Available values are: “id” and “date”. Default value is set to “id”. This parameter is used in conjunction with “since” and defines after which point trades must be returned.
since
  • When the URL includes the query parameter name: “date”, this parameter will expect a Linux timestamp. The endpoint will return all trades that have been completed after a given moment in time.
  • Note: Trades that have been completed within 24 hours will not show up on the record.
  • When it is set to “id”, then all returned offers should have been completed after a given trade “id”.
limit
  • When performing this query parameter the maximum hard cap is 100. If you try to set a number over 100, you will still receive 100 trades.

Sample requests

Here are examples of URLs that include query parameter names/filters:
  • https://paxful.com/data/trades?since=500 — returns all trades which IDs is higher than 500.
  • https://paxful.com/data/trades?sincetype=date&since=1447733179 — all trades that were created after 1447733179 (Tuesday, 17 November 2015 04:06:19 GMT)
  • https://paxful.com/data/trades?limit=20
In the last example the limit is 20 (limit=20). This is where the maximum hard cap of 100 is applied.

Response

The payment methods and groups may change over time. This is because at Paxful we are always adjusting the payment methods and groups for a better buying and customer experience.
[
    {
        "id":420, # Trade ID
        "date":"1435428778", # Unix timestamp
        "amount":"1.10324132", # Amount of BTC traded
        "price":"500.00", # Price per 1 bitcoin
        "payment_method":"Paypal My Cash",
        "payment_method_group":"Gift cards",
        "currency":"USD",
        "type":"sell" # Indicates 'buy' or 'sell' trade
    },
    {
        "id":425,
        "date":"1435498191",
        "amount":"1.75106815",
        "price":"500.00",
        "payment_method":"Western Union",
        "payment_method_group":"Cash deposits",
        "currency":"USD",
        "type":"buy"
    },
    {
        "id":432,
        "date":"1435485454",
        "amount":"0.17927704",
        "price":"49.00",
        "payment_method":"Paypal",
        "payment_method_group":"Online transfers",
        "currency":"EUR",
        "type":"buy"
    }
]
This website uses cookies to ensure you get the best experience on our website.Learn more