Get Trades by Signature

POST

trades

signatures

curl --request POST \
  --url https://frontend-api-v3.pump.fun/trades/signatures \
  --header 'Content-Type: application/json' \
  --data '
{
  "signatures": [
    {}
  ]
}
'

{
  "trades": [
    {
      "signature": "<string>",
      "mint": "<string>",
      "timestamp": "<string>",
      "tradeDirection": "<string>",
      "amount": 123,
      "user": "<string>"
    }
  ]
}

Authentication

This endpoint requires JWT authentication via the Authorization: Bearer <token> header.

Request Body

signatures

array

required

Array of transaction signature strings to retrieve trades for

{
  "signatures": [
    "5wHu1qwD7...",
    "3xKp9nM2s...",
    "7yTn4rP8k..."
  ]
}

Response

trades

array

Array of trade objects matching the provided signatures

Show trade properties

signature

string

Transaction signature of the trade

mint

string

Token mint address

timestamp

string

When the trade occurred

tradeDirection

string

Whether this was a buy or sell

amount

number

Trade amount

user

string

User wallet address

Example Request

curl -X POST "https://frontend-api-v3.pump.fun/trades/signatures" \
  -H "Authorization: Bearer <your_token>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "signatures": [
      "5wHu1qwD7nP2kLmR9vXs8TyC4jFhN6gE3bKpM1aQ2xYuZv",
      "3xKp9nM2sV8tLqR4yHj6WcF1dN5gP7eKmB9vXs2TyC0zAu"
    ]
  }'

Replace <your_token> with your actual JWT token and use valid Solana transaction signatures.

Use Cases

Verify Specific Transactions

Use this endpoint to retrieve detailed information about specific trades when you have their transaction signatures. This is useful for:

Verifying trade execution
Building transaction history views
Reconciling on-chain data with platform data
Investigating specific trades

Batch Trade Lookup

Retrieve multiple trades in a single request by providing an array of signatures:

import requests

# Get multiple trades at once
signatures_to_check = [
    "sig1...",
    "sig2...",
    "sig3...",
    "sig4...",
    "sig5..."
]

url = "https://frontend-api-v3.pump.fun/trades/signatures"
headers = {
    "Authorization": "Bearer <your_token>",
    "Accept": "application/json",
    "Content-Type": "application/json"
}

response = requests.post(url, headers=headers, json={"signatures": signatures_to_check})
trades = response.json()

for trade in trades:
    print(f"Trade {trade['signature']}: {trade['amount']} {trade['tradeDirection']}")

For additional trade query options, see:

POST /trades/signatures/small - Lightweight version with minimal data