`/data/query`

GEThttps://api.aori.io

Query historical orders with advanced filtering options and pagination support. Returns order data with metadata for analytics and order management.

Request

Name
orderHash
Type
string
Description
Filter by specific order hash
Name
offerer
Type
string
Description
Filter by offerer address
Name
recipient
Type
string
Description
Filter by recipient address
Name
inputToken
Type
string
Description
Filter by input token contract address
Name
inputChain
Type
string
Description
Filter by input chain identifier
Name
outputToken
Type
string
Description
Filter by output token contract address
Name
outputChain
Type
string
Description
Filter by output chain identifier
Name
minValue
Type
string
Description
Minimum USD value filter
Name
maxValue
Type
string
Description
Maximum USD value filter
Name
srcTx
Type
string
Description
Filter by source transaction hash
Name
dstTx
Type
string
Description
Filter by destination transaction hash
Name
status
Type
string
Description
Filter by order status (Pending, Received, Completed, Failed)
Name
minTime
Type
number
Description
Start of time range filter (Unix timestamp)
Name
maxTime
Type
number
Description
End of time range filter (Unix timestamp)
Name
page
Type
number
Description
Page number for pagination (1-based, default: 1)
Name
limit
Type
number
Description
Number of records per page (default: 50, max: 100)

cURL

curl "https://api.aori.io/data/query?offerer=0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b&status=Completed&page=1&limit=10"

Response

Name
orders
Type
array
Description
Array of order objects matching the query criteria
Name
pagination
Type
object
Description
Pagination metadata for the query results

Order Object

Name
orderHash
Type
string
Description
Unique identifier for the order
Name
offerer
Type
string
Description
Address that initiated the order
Name
recipient
Type
string
Description
Address receiving the output tokens
Name
inputToken
Type
string
Description
Input token contract address
Name
inputAmount
Type
string
Description
Amount of input tokens
Name
inputChain
Type
string
Description
Source chain identifier
Name
inputTokenValueUsd
Type
string
Description
USD value of input tokens
Name
outputToken
Type
string
Description
Output token contract address
Name
outputAmount
Type
string
Description
Amount of output tokens
Name
outputChain
Type
string
Description
Destination chain identifier
Name
outputTokenValueUsd
Type
string
Description
USD value of output tokens
Name
startTime
Type
number
Description
Unix timestamp when order became valid
Name
endTime
Type
number
Description
Unix timestamp when order expires
Name
srcTx
Type
string | null
Description
Source chain transaction hash
Name
dstTx
Type
string | null
Description
Destination chain transaction hash
Name
timestamp
Type
number
Description
Unix timestamp of most recent event
Name
status
Type
string
Description
Current order status

Pagination Object

Name
currentPage
Type
number
Description
Current page number
Name
limit
Type
number
Description
Number of records per page
Name
totalRecords
Type
number
Description
Total number of matching records
Name
totalPages
Type
number
Description
Total number of pages

Response

{
  "orders": [
    {
      "orderHash": "0x1234567890abcdef1234567890abcdef12345678",
      "offerer": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b",
      "recipient": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b",
      "inputToken": "0x4200000000000000000000000000000000000006",
      "inputAmount": "1000000000000000000",
      "inputChain": "base",
      "inputTokenValueUsd": "3200.00",
      "outputToken": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
      "outputAmount": "3200000000",
      "outputChain": "arbitrum",
      "outputTokenValueUsd": "3200.00",
      "startTime": 1703001600,
      "endTime": 1703005200,
      "srcTx": "0xabc123...",
      "dstTx": "0xdef456...",
      "timestamp": 1703001780,
      "status": "Completed"
    },
    [...],
  ],
  "pagination": {
    "currentPage": 1,
    "limit": 10,
    "totalRecords": 1,
    "totalPages": 1
  }
}