Our own visit statistics are always on. Google Analytics, which helps us understand how people use our public pages (not your signed-in workspace), is enabled only with your permission. See our Privacy policy.

POST

API health

24h health
Normal
24h average time
—
  • Healthy / normal
  • Available
  • Limited
  • Mostly down
Normal

List the latest on-chain trades of one Polymarket market, with side, outcome, price, shares, dollar amount, fee, time and transaction hash.

Price $6.81 per 1,000 requests ($0.006806 per call). Failed calls and empty results are not charged. Synchronous. For slow jobs add "mode": "async" to the body, take the job_id and poll.

AI prompt

Please help me write a data collection script with the EveryInfra Polymarket Trades endpoint (polymarket/trades).

How the endpoint works:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to polymarket and action to trades, and put the parameters inside params.
- Required parameters:
  - market: The market for trades: its slug (such as will-donald-trump-win-the-2024-us-presidential-election), its 0x condition ID or its polymarket.com link, taken from a markets row.
- Optional parameters:
  - limit: The most rows to return in this call, an integer from 1 to 100. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. (default: 50)
- Returns a list of records. Main fields of each record: tx_hash (On-chain transaction hash of the trade…), order_hash (Hash of the order behind the trade (tra…), side (BUY or SELL, from the maker's side (tra…), outcome (The outcome traded, such as Yes or a te…), price (Trade price, 0 to 1 (trades)), shares (Shares traded (trades)), amount_usd (Trade value in US dollars (trades)), fee_usd (Fee in US dollars (trades)), traded_at (Trade time, ISO 8601 UTC (trades)), market_slug (Slug of the traded market (trades)), condition_id (The market's on-chain condition ID (0x.…), token_id (ID of the outcome token traded (trades)); 15 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=polymarket.
- Example request body:
{
  "platform": "polymarket",
  "action": "trades",
  "params": {
    "market": "will-bitcoin-reach-110000-by-december-31-2026-658-339-969"
  }
}
- Price: $6.81 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.

Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.

Request parameters

NameInTypeRequiredDefaultDescription
AuthorizationheaderstringYes-Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
platformbodystringYespolymarketPlatform identifier, fixed value.
actionbodystringYestradesCapability identifier, fixed value.
marketbody.paramsstringYes-The market for trades: its slug (such as will-donald-trump-win-the-2024-us-presidential-election), its 0x condition ID or its polymarket.com link, taken from a markets row.
limitbody.paramsinteger (1–100)No50The most rows to return in this call, an integer from 1 to 100. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge.

Code samples

bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "polymarket",
  "action": "trades",
  "params": {
    "market": "will-bitcoin-reach-110000-by-december-31-2026-658-339-969"
  }
}'

OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.

Response example

Field preview

No sample response is available for these parameters yet. This preview shows the response shape and fields from the API definition, with … as placeholders; it is not the result of a live call.

json
{
  "id": "req_…",
  "platform": "polymarket",
  "action": "trades",
  "results": [
    {
      "tx_hash": …,
      "order_hash": …,
      "side": …,
      "outcome": …,
      "price": …,
      "shares": …,
      "amount_usd": …,
      "fee_usd": …,
      "traded_at": …,
      "market_slug": …,
      "condition_id": …,
      "token_id": …,
      "title": …,
      "maker_wallet": …,
      "taker_wallet": …,
      "platform": …
    }
  ],
  "count": …,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Response fields

Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.

FieldMeaning
tx_hashOn-chain transaction hash of the trade (trades).
order_hashHash of the order behind the trade (trades).
sideBUY or SELL, from the maker's side (trades).
outcomeThe outcome traded, such as Yes or a team name (trades).
priceTrade price, 0 to 1 (trades).
sharesShares traded (trades).
amount_usdTrade value in US dollars (trades).
fee_usdFee in US dollars (trades).
traded_atTrade time, ISO 8601 UTC (trades).
market_slugSlug of the traded market (trades).
condition_idThe market's on-chain condition ID (0x...); pass it as market to trades.
token_idID of the outcome token traded (trades).
titleTitle. null when the platform has no titles (for example text-only posts).
maker_walletMaker wallet address, public on-chain (trades).
taker_walletTaker wallet address, public on-chain (trades).
platformSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).

Errors and billing

401
Missing or invalid key.
402
Insufficient balance. Top up first.
422
Invalid parameter name or value. Fix it using the suggestions in the error. No charge.
429
Per-minute request limit reached. Wait for Retry-After, then try again.
503
Could not complete. The held charge is returned to your balance. If the outcome is unknown, verify it before you retry.
200 empty
No data. No charge.

Errors

Official references

Used only to check objects and terms. They do not imply authorization or endorsement of EveryInfra by the platform.

  • Polymarket docs: markets and events ↗

    Polymarket's official docs describe an event as the question shown to users and each market as a resolvable Yes/No condition identified by its slug and condition ID, which is why `market` accepts either. Trade data comes from the chain, not from this source.

    Checked 2026-11-01