{
  "generated_at": "2026-04-24T15:01:35.625676+00:00",
  "slug": "slamai-dev-chain-trades",
  "title": "slamai \u00b7 On-Chain Trade History",
  "url": "https://slamai.dev/chain/trades",
  "category": "data",
  "summary": "Fetch historical and real-time trade data from multiple blockchain networks with flexible filtering.",
  "seo": {
    "title": "Blockchain Trade Data API - x402 Micropayment Access",
    "description": "Query on-chain trades across Ethereum, Base, and other networks via x402 protocol. Pay 0.00083 USDC per call. Filter by block range, timestamp, or trade size."
  },
  "use_cases": [
    "Analyze whale trading patterns across chains",
    "Build DEX volume analytics dashboards",
    "Detect arbitrage opportunities from trade flow data"
  ],
  "ideal_buyer": "Quantitative traders and on-chain analysts needing granular trade data across multiple blockchain networks.",
  "example_prompt": "Get all trades on Base from the last 100 blocks with USD value above $10,000.",
  "example_request_body": {
    "days": 1,
    "max_usd": 1000000,
    "min_usd": 10000,
    "blockchain": "base"
  },
  "risk_notes": [],
  "pricing_sanity": {
    "flag": "cheap_outlier",
    "ratio": 0.028,
    "median_category_atomic": 30000
  },
  "pricing_review_required": false,
  "pricing_decimal_suspect": false,
  "trust_tier": "indexed_external",
  "accepts": [
    {
      "scheme": "exact",
      "network": "base",
      "pay_to": "0xd85096faec1ac03075667b4c1a1661f5623bf111",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "max_amount_required_atomic": "830",
      "max_timeout_seconds": 300,
      "mime_type": "application/json",
      "description": "Returns trades across the entire blockchain, with optional filtering by block range or timestamp range.",
      "verified": false,
      "hints": {
        "input": {
          "type": "http",
          "method": "GET",
          "queryParams": {
            "num": {
              "type": "integer",
              "description": "The maximum number of records to return."
            },
            "side": {
              "enum": [
                "buy",
                "sell",
                "all"
              ],
              "type": "string",
              "description": "Specifies trade side for the implied quote token address. Wrapped native tokens and stablecoins are implied to be the base token in the trade, making the other token the quote. Otherwise the token with the lowest fully-diluted value (FDV) is assumed to be the quote token."
            },
            "order": {
              "type": "string",
              "description": "Sort order: asc (oldest first) or desc (newest first)."
            },
            "max_usd": {
              "type": "number",
              "description": "Maximum trade size in USD. Filters out trades with an estimated USD value above this threshold. Calculated using on-chain price data at the time of the trade. Note: Adds additional SLAM cost to the query. A maximum of 10,000 trades that would otherwise match this query will be scanned."
            },
            "min_usd": {
              "type": "number",
              "description": "Minimum trade size in USD. Filters out trades with an estimated USD value below this threshold. Calculated using on-chain price data at the time of the trade. Note: Adds additional SLAM cost to the query. A maximum of 10,000 trades that would otherwise match this query will be scanned."
            },
            "blockchain": {
              "enum": [
                "ethereum",
                "base"
              ],
              "type": "string",
              "required": true,
              "description": "The blockchain network to query."
            },
            "start_block": {
              "type": "integer",
              "description": "Block number to start the search from (inclusive). Defaults to the latest block in desc order, or the genesis block in asc order."
            },
            "estimate_cost": {
              "type": "boolean",
              "description": "When true returns the SLAM token cost for this query. It does not return any data or incur any actual charges."
            },
            "start_log_index": {
              "type": "integer",
              "description": "Log index within the starting block to resume pagination or refine the starting point."
            },
            "start_timestamp": {
              "type": "string",
              "description": "Start searching from this UTC timestamp (inclusive). If provided, overrides start_block as the starting point."
            }
          }
        },
        "output": {
          "status": 200,
          "content": {
            "application/json": {
              "schema": {
                "oneOf": [
                  {
                    "type": "object",
                    "properties": {
                      "slam": {
                        "type": "number",
                        "format": "double",
                        "description": "The SLAM token cost for this API call."
                      },
                      "chain": {
                        "type": "string",
                        "description": "The name of the blockchain network (e.g., base)."
                      },
                      "cursor": {
                        "type": "object",
                        "properties": {
                          "start_block": {
                            "type": "integer",
                            "format": "int32",
                            "description": "The block number at which to continue fetching results."
                          },
                          "start_log_index": {
                            "type": "integer",
                            "format": "int32",
                            "description": "The log index within the block at which to continue."
                          }
                        }
                      },
                      "trades": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "usd": {
                              "type": "number",
                              "format": "double",
                              "description": "The USD value of the trade at the time of execution."
                            },
                            "pair": {
                              "type": "object",
                              "properties": {
                                "name": {
                                  "type": "string",
                                  "description": "Pair name (e.g., WETH/USDC)."
                                },
                                "labels": {
                                  "type": "string",
                                  "nullable": true,
                                  "description": "Additional tags or labels describing the pair."
                                },
                                "address": {
                                  "type": "string",
                                  "description": "The pair or pool contract address (V2/V3) or creation transaction hash (V4)."
                                }
                              }
                            },
                            "side": {
                              "type": "string",
                              "description": "The side of the trade: \"buy\" or \"sell\", relative to the trader."
                            },
                            "maker": {
                              "type": "object",
                              "properties": {
                                "name": {
                                  "type": "string",
                                  "nullable": true,
                                  "description": "A human-readable label for the address (if available)."
                                },
                                "labels": {
                                  "type": "string",
                                  "nullable": true,
                                  "description": "Additional tags or labels describing the address."
                                },
                                "address": {
                                  "type": "string",
                                  "description": "The maker address."
                                }
                              }
                            },
                            "price": {
                              "type": "number",
                              "format": "double",
                              "description": "The execution price expressed as quoteToken per baseToken."
                            },
                            "sender": {
                              "type": "object",
                              "properties": {
                                "name": {
                                  "type": "string",
                                  "nullable": true,
                                  "description": "A human-readable label for the address (if available)."
                                },
                                "labels": {
                                  "type": "string",
                                  "nullable": true,
                                  "description": "Additional tags or labels describing the address."
                                },
                                "address": {
                                  "type": "string",
                                  "description": "The address that invoked the pool\u2019s swap function (event sender); often a router, aggregator, or other contract executing the swap."
                                }
                              }
                            },
                            "trader": {
                              "type": "object",
                              "properties": {
                                "flow": {
                                  "type": "object",
                                  "properties": {
                                    "buy": {
                                      "type": "object",
                                      "properties": {
                                        "raw": {
                                          "type": "number",
                                          "format": "double",
                                          "nullable": true,
                                          "description": "Raw flow score."
                                        },
                                        "tier": {
                                          "type": "string",
                                          "description": "Flow tier (e.g., \"Flood\")"
                                        }
                                      }
                                    },
                                    "sell": {
                                      "type": "object",
                                      "properties": {
                                        "raw": {
                                          "type": "number",
                                          "format": "double",
                                          "nullable": true,
                                          "description": "Raw flow score."
                                        },
                                        "tier": {
                                          "type": "string",
                                          "description": "Flow tier (e.g., \"Flood\")"
                                        }
                                      }
                                    },
                                    "total": {
                                      "type": "object",
                                      "properties": {
                                        "raw": {
                                          "type": "number",
                                          "format": "double",
                                          "nullable": true,
                                          "description": "Raw flow score."
                                        },
                                        "tier": {
                                          "type": "string",
                                          "description": "Flow tier (e.g., \"Flood\")"
                                        }
                                      }
                                    }
                                  }
                                },
                                "mass": {
                                  "type": "object",
                                  "properties": {
                                    "raw": {
                                      "type": "number",
                                      "format": "double",
                                      "nullable": true,
                                      "description": "Raw mass score."
                                    },
                                    "tier": {
                                      "type": "string",
                                      "description": "Mass tier (e.g., \"Whale\", \"Dolphin\", \"Fish\", etc.)"
                                    }
                                  }
                                },
                                "name": {
                                  "type": "string",
                                  "nullable": true,
                                  "description": "A human-readable label for the address (if available)."
                                },
                                "entry": {
                                  "type": "object",
                                  "properties": {
                                    "utc": {
                                      "type": "string",
                                      "description": "Timestamp of entry (ISO 8601 format)."
                                    },
                                    "block": {
                                      "type": "integer",
                                      "format": "int32",
                                      "description": "Block number of entry."
                                    },
                                    "method": {
                                      "type": "string",
                                      "description": "How the wallet initially received the token (e.g., \"DEX\", \"Airdrop\", \"Transfer\")"
                                    },
                                    "parent": {
                                      "type": "string",
                                      "nullable": true,
                                      "description": "Address of the immediate parent wallet/contract that transferred tokens to this wallet."
                                    },
                                    "grand_parent": {
                                      "type": "string",
                                      "nullable": true,
                                      "description": "Address of the upstream source two levels back in the transfer chain."
                                    },
                                    "token_amount": {
                                      "type": "number",
                                      "format": "double",
                                      "description": "Amount received at entry."
                                    },
                                    "great_grand_parent": {
                                      "type": "string",
                                      "nullable": true,
                                      "description": "Address of the upstream source three levels back in the transfer chain."
                                    }
                                  }
                                },
                                "epoch": {
                                  "type": "object",
                                  "properties": {
                                    "raw": {
                                      "type": "number",
                                      "format": "double",
                                      "nullable": true,
                                      "description": "Raw epoch score."
                                    },
                                    "tier": {
                                      "type": "string",
                                      "description": "Epoch tier (e.g., \"Early Adopter\")"
                                    }
                                  }
                                },
                                "labels": {
                                  "type": "string",
                                  "nullable": true,
                                  "description": "Additional tags or labels describing the address."
                                },
                                "address": {
                                  "type": "string",
                                  "description": "The trader address."
                                },
                                "reputation": {
                                  "type": "object",
                                  "properties": {
                                    "raw": {
                                      "type": "number",
                                      "format": "double",
                                      "nullable": true,
                                      "description": "Raw reputation score."
                                    },
                                    "tier": {
                                      "type": "string",
                                      "description": "Reputation label (e.g., \"A\")"
                                    }
                                  }
                                },
                                "intelligence": {
                                  "type": "object",
                                  "properties": {
                                    "iq": {
                                      "type": "number",
                                      "format": "double",
                                      "nullable": true,
                                      "description": "Raw IQ score."
                                    },
                                    "tier": {
                                      "type": "string",
                                      "description": "Intelligence label (e.g., \"Genius\")"
                                    }
                                  }
                                },
                                "maker_presence": {
                                  "type": "object",
                                  "properties": {
                                    "raw": {
                                      "type": "number",
                                      "format": "double",
                                      "nullable": true,
                                      "description": "Raw presence score."
                                    },
                                    "tier": {
                                      "type": "string",
                                      "description": "Presence tier (e.g., \"Active\")"
                                    }
                                  }
                                },
                                "base_token_holding": {
                                  "type": "object",
                                  "properties": {
                                    "held": {
                                      "type": "number",
                                      "format": "double",
                                      "nullable": true,
                                      "description": "Amount held (non-staked)."
                                    },
                                    "staked": {
                                      "type": "number",
                                      "format": "double",
                                      "nullable": true,
                                      "description": "Net amount transferred to a staking contract."
                                    },
                                    "balance": {
                                      "type": "number",
                                      "format": "double",
                                      "description": "Current wallet balance of the token."
                                    },
                                    "value_usd": {
                                      "type": "number",
                                      "format": "double",
                                      "description": "USD value of the token holdings."
                                    },
                                    "staked_pct": {
                                      "type": "number",
                                      "format": "double",
                                      "nullable": true,
                                      "description": "Percentage of the wallet's token balance transferred to a staking contract."
                                    },
                                    "supply_pct": {
                                      "type": "number",
                                      "format": "double",
                                      "description": "Percentage of the token's total supply held."
                                    }
                                  }
                                },
                                "quote_token_holding": {
                                  "type": "object",
                                  "properties": {
                                    "held": {
                                      "type": "number",
                                      "format": "double",
                                      "nullable": true,
                                      "description": "Amount held (non-staked)."
                                    },
                                    "staked": {
                                      "type": "number",
                                      "format": "double",
                                      "nullable": true,
                                      "description": "Net amount transferred to a staking contract."
                                    },
                                    "balance": {
                                      "type": "number",
                                      "format": "double",
                                      "description": "Current wallet balance of the token."
                                    },
                                    "value_usd": {
                                      "type": "number",
                                      "format": "double",
                                      "description": "USD value of the token holdings."
                                    },
                                    "staked_pct": {
                                      "type": "number",
                                      "format": "double",
                                      "nullable": true,
                                      "description": "Percentage of the wallet's token balance transferred to a staking contract."
                                    },
                                    "supply_pct": {
                                      "type": "number",
                                      "format": "double",
                                      "description": "Percentage of the token's total supply held."
                                    }
                                  }
                                }
                              }
                            },
                            "recipient": {
                              "type": "object",
                              "properties": {
                                "name": {
                                  "type": "string",
                                  "nullable": true,
                                  "description": "A human-readable label for the address (if available)."
                                },
                                "labels": {
                                  "type": "string",
                                  "nullable": true,
                                  "description": "Additional tags or labels describing the address."
                                },
                                "address": {
                                  "type": "string",
                                  "description": "The address designated to receive output tokens in the swap event (Uniswap V2: event to; Uniswap V3: event recipient). May be an intermediary contract."
                                }
                              }
                            },
                            "base_token": {
                              "type": "object",
                              "properties": {
                                "name": {
                                  "type": "string",
                                  "description": "Full token name."
                                },
                                "amount": {
                                  "type": "number",
                                  "format": "double",
                                  "description": "The amount of the token exchanged (normalized by token decimals)."
                                },
                                "symbol": {
                                  "type": "string",
                                  "description": "Token symbol."
                                },
                                "address": {
                                  "type": "string",
                                  "description": "Token contract address."
                                }
                              }
                            },
                            "quote_token": {
                              "type": "object",
                              "properties": {
                                "name": {
                                  "type": "string",
                                  "description": "Full token name."
                                },
                                "amount": {
                                  "type": "number",
                                  "format": "double",
                                  "description": "The amount of the token exchanged (normalized by token decimals)."
                                },
                                "symbol": {
                                  "type": "string",
                                  "description": "Token symbol."
                                },
                                "address": {
                                  "type": "string",
                                  "description": "Token contract address."
                                }
                              }
                            },
                            "transaction": {
                              "type": "object",
                              "properties": {
                                "utc": {
                                  "type": "string",
                                  "description": "UTC timestamp of the transaction (ISO 8601 format)."
                                },
                                "hash": {
                                  "type": "string",
                                  "description": "Transaction hash."
                                },
                                "block": {
                                  "type": "integer",
                                  "format": "int32",
                                  "description": "Block number containing the transaction."
                                },
                                "method": {
                                  "type": "string",
                                  "nullable": true,
                                  "description": "Decoded contract method name (if available)."
                                },
                                "log_index": {
                                  "type": "integer",
                                  "format": "int32",
                                  "description": "Log index for this transfer within the block."
                                }
                              }
                            }
                          }
                        },
                        "description": "List of token trade records matching the query."
                      }
                    }
                  },
                  {
                    "type": "object",
                    "properties": {
                      "slam": {
                        "type": "number",
                        "format": "double"
                      }
                    }
                  }
                ]
              }
            }
          },
          "description": "OK"
        }
      }
    }
  ],
  "origin": {
    "slug": "slamai-dev",
    "host": "slamai.dev",
    "title": "slamai.dev",
    "description": "An x402-payable API origin hosted at slamai.dev. No service description available due to server error.",
    "url": "https://slamai.dev"
  },
  "json_ld": {
    "@id": "https://x402all.com/resource/slamai-dev-chain-trades",
    "url": "https://x402all.com/resource/slamai-dev-chain-trades",
    "name": "slamai \u00b7 On-Chain Trade History",
    "@type": "WebAPI",
    "offers": {
      "url": "https://x402all.com/resource/slamai-dev-chain-trades",
      "@type": "Offer",
      "price": "0.00083",
      "availability": "https://schema.org/InStock",
      "priceCurrency": "USDC",
      "priceSpecification": {
        "@type": "UnitPriceSpecification",
        "price": "0.000830",
        "unitText": "call",
        "priceCurrency": "USDC"
      },
      "eligibleCustomerType": "Agent",
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "paymentNetwork",
          "value": "base"
        },
        {
          "@type": "PropertyValue",
          "name": "paymentAsset",
          "value": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
        }
      ]
    },
    "sameAs": "https://slamai.dev/chain/trades",
    "@context": "https://schema.org",
    "provider": {
      "@id": "https://x402all.com/server/slamai-dev",
      "url": "https://slamai.dev",
      "name": "slamai.dev",
      "@type": "Organization"
    },
    "identifier": "slamai-dev-chain-trades",
    "description": "Query on-chain trades across Ethereum, Base, and other networks via x402 protocol. Pay 0.00083 USDC per call. Filter by block range, timestamp, or trade size.",
    "potentialAction": {
      "@type": "BuyAction",
      "target": "https://axon402.com/test-buy?resource=slamai-dev-chain-trades",
      "description": "Test-buy this endpoint on AXON"
    },
    "applicationCategory": "data"
  },
  "axon_deep_link": "https://axon402.com/test-buy?resource=slamai-dev-chain-trades"
}