WAX Smart ContractInstall

Summary

Fetch rows from a WAX smart contract table

Inputs

• contractName (required) — Name of the smart contract (e.g., eosio.token, atomicassets)
• tableName (required) — Name of the table to query
• scope (required) — Scope of the table (usually an account name or contract name)
• lowerBound — Lower bound for the query (optional). Use account names for name type, numbers for i64.
• upperBound — Upper bound for the query (optional). Use account names for name type, numbers for i64.
• limit — Max number of results to return
• keyType — Type of the primary key
• autoConvert — Whether to automatically convert account names in bounds to i64 format
• indexPosition — Position of the index (1 for primary, 2+ for secondary indexes)
• endpoint (required) — WAX blockchain API endpoint (default https://wax.greymass.com)

Output shape

an object containing the retrieved rows and pagination data

Includes rows, more, and next_key; also returns query parameters and bound conversion details.

Examples

Example 1: Query the first 20 entries of the 'accounts' table in the 'eosio' scope

contractName=eosio,tableName=accounts,scope=eosio,limit=20,keyType=i64,endpoint=https://wax.greymass.com

Example 2: Retrieve all entries of a table with i64 key type, using default bounds

contractName=atomicassets,tableName=items,scope=atomicassets,keyType=i64,autoConvert=true,indexPosition=1,limit=100

Example 3: Fetch a secondary index page using custom bounds

contractName=mycontract,tableName=players,scope=myaccount,lowerBound=1000,upperBound=2000,indexPosition=2,keyType=name