GET /v1/tx/{txHash} — Retrieve Transaction Details

Use this endpoint to look inside a single on-chain transaction. Pass a transaction hash and receive a human-readable sentence that summarises the entire trade, plus an actions array that breaks it down into every individual fill. This is useful when you want to understand exactly what happened inside a complex transaction — for example, how many counterparties were matched, at what prices, and how the shares and USDC were distributed across each fill.

Request

GET https://orbscan.com/open-api/v1/tx/{txHash}

Path Parameters

string

required

The transaction hash to decode. Must be a valid 0x-prefixed Ethereum transaction hash.Example: 0x66dc87fb47faf587002b89d183dbb9505fc7ef80da5e6ec49e271278e8d95fad

Example Request

curl "https://orbscan.com/open-api/v1/tx/0x66dc87fb47faf587002b89d183dbb9505fc7ef80da5e6ec49e271278e8d95fad" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

tx_hash = "0x66dc87fb47faf587002b89d183dbb9505fc7ef80da5e6ec49e271278e8d95fad"
url = f"https://orbscan.com/open-api/v1/tx/{tx_hash}"

headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}

response = requests.get(url, headers=headers)
print(response.json())

Response

boolean

true when the request succeeds, false otherwise.

string

Application-level status code. "0" indicates success.

string

Human-readable status message, for example "success".

object

The decoded transaction detail.

Show TransactionDetail fields

string

The transaction hash that was queried.

integer

Block height at which this transaction was confirmed.

integer

Unix timestamp (seconds) of the block containing this transaction.

string

The primary wallet address this transaction is attributed to.

string

High-level source classification for the transaction, for example TRADE.

string

Top-level action for the transaction, for example Buy or Sell.

string

A plain-English summary of the entire transaction. For example: "Buy 3604.58 No for $3546.12269 in Will Bitcoin dip to $59,000 on June 9?". Use this field when you need a ready-to-display description without any further parsing.

string

URL-friendly slug for the market this transaction occurred in.

string

Polymarket market ID.

TransactionAction[]

Array of every individual on-chain fill contained in this transaction. A single trade can produce multiple fills because one order is often matched against several counterparties at slightly different prices.

Show TransactionAction fields

string

Action type for this fill, for example Buy or Sell.

string

Polymarket outcome token ID involved in this fill.

string

Number of shares exchanged in this fill.

string

Price per share for this fill, in cents. Divide by 100 to convert to dollars.

string

USDC value of this fill (shares × price, adjusted for decimals).

string

Wallet address that performed this fill.

string

On-chain transaction hash (same as the top-level txHash).

integer

Unix timestamp (seconds) of the block containing this fill.

string

Fee charged for this fill, in USDC.

string

Polymarket market ID for this fill.

string

URL-friendly slug for the market.

string

URL-friendly slug for the parent event.

string

Human-readable title of the market.

string

Which outcome this fill is on. Either Yes or No.

integer

Zero-based index of the outcome: 0 = Yes, 1 = No.

string

URL of the market’s logo image.

string | null

Whether the actor was a MAKER or TAKER in this fill. null for non-trade actions.

Example Response

{
  "success": true,
  "code": "0",
  "message": "success",
  "data": {
    "txHash": "0x66dc87fb47faf587002b89d183dbb9505fc7ef80da5e6ec49e271278e8d95fad",
    "blockNumber": 88229726,
    "blockTimestamp": 1781049574,
    "profileAddress": "0xaac2469db4c243a2931acc252967b171bd97e8ce",
    "sourceType": "TRADE",
    "actionType": "Buy",
    "sentence": "Buy 3604.58 No for $3546.12269 in Will Bitcoin dip to $59,000 on June 9?",
    "marketSlug": "will-bitcoin-dip-to-59k-on-june-9",
    "marketId": "2475928",
    "actions": [
      {
        "actionType": "Buy",
        "assetId": "38163660360188728397792916713023875464787138529265352624189549073473314732690",
        "shares": "3604.58",
        "price": "98.378249",
        "txValue": "3546.12269",
        "actor": "0xaac2469db4c243a2931acc252967b171bd97e8ce",
        "txHash": "0x66dc87fb47faf587002b89d183dbb9505fc7ef80da5e6ec49e271278e8d95fad",
        "blockTimestamp": 1781049574,
        "fee": "4.02564",
        "marketId": "2475928",
        "marketSlug": "will-bitcoin-dip-to-59k-on-june-9",
        "eventSlug": "what-price-will-bitcoin-hit-on-june-9",
        "marketTitle": "Will Bitcoin dip to $59,000 on June 9?",
        "positionSide": "No",
        "outcomeIndex": 1,
        "marketLogo": "https://polymarket-upload.s3.us-east-2.amazonaws.com/BTC-fullsize.png",
        "liquidityRole": "TAKER"
      }
    ]
  }
}

Understanding the Response

The `sentence` field

The sentence field gives you a single, ready-to-read plain-English summary of everything the transaction did. In the example above, "Buy 3604.58 No for $3546.12269 in Will Bitcoin dip to $59,000 on June 9?" tells you the direction (Buy), the quantity (3604.58 shares), the outcome (No), the total USDC spent ($3546.12269), and the market title — all in one string. Use this field whenever you need a compact, human-readable label for a transaction without further parsing.

The `actions` array

The actions array breaks the transaction down into its individual on-chain fills. A single trade often contains more than one fill because a market order can be matched against multiple resting limit orders at slightly different prices. Each element in actions represents one such match: it records the exact shares, price (in cents), txValue (USDC), the actor wallet, and whether they acted as the MAKER or TAKER. Summing the txValue across all fills gives you the total USDC value for the transaction, which matches the figure in sentence.

Overview

Endpoints

GET /v1/tx/{txHash} — Retrieve Transaction Details

Request

Path Parameters

Example Request

Response

Example Response

Understanding the Response

The `sentence` field

The `actions` array

​Request

​Path Parameters

​Example Request

​Response

​Example Response

​Understanding the Response

​The sentence field

​The actions array

Request

Path Parameters

Example Request

Response

Example Response

Understanding the Response

The `sentence` field

The `actions` array