Intents Explorer API
What is Intents Explorer API?
The Intents Explorer API provides programmatic access to historical 1Click Swap transactions and their statuses, mirroring the data available on the NEAR Intents Explorer. This API is read-only and features a single HTTP GET endpoint designed specifically for distribution channels and analytical services to fetch and filter 1Click Swap history.
Key Features
The API is tailored exclusively for 1Click Swap transactions and is not intended for general NEAR Intents activity.
Retrieve and filter swaps by token symbols, transaction hashes, timestamps, and status, enabling precise integration with your analytics or dashboarding tools.
Mirrors the same real-time and historical swap data shown in the NEAR Intents Explorer interface.
Documentation & Access
Swagger UI: https://explorer.near-intents.org/api/docs
OpenAPI Spec (YAML): https://explorer.near-intents.org/api/v0/openapi.yaml
API Specification (v0)
Auto-generate clients using our OpenAPI spec.
API Endpoints
Last known deposit address. Get one page first, then specify the direction and use the last depositAddress that you got (last from the top or last from the bottom, depending on the direction you wanna go) to fetch next page. To get everything, repeat this until the endpoint returns an empty array
Direction of pagination. 'next' - get older transactions, 'prev' - get newer transactions. Default: 'next'.
The number of transactions to return. Default: 50. Max: 1000
Search by deposit address, recipient, or intent hashes
Filter by origin chain ID
Filter by destination chain ID
Filter by referral
Filter by affiliate that is stored in the fees
Filter by comma-separated statuses. Allowed values: FAILED, INCOMPLETE_DEPOSIT, PENDING_DEPOSIT, PROCESSING, REFUNDED, SUCCESS. Default: FAILED, PROCESSING, REFUNDED, SUCCESS
Show transactions from test accounts and with test-related referrals
Filter by start timestamp (inclusive). Use ISO 8601 format
Filter by start timestamp (inclusive). Use Unix timestamp
Filter by end timestamp (non-inclusive). Use ISO 8601 format
Filter by end timestamp (non-inclusive). Use Unix timestamp
Last related receipt ID. Currently ignored
GET /api/v0/transactions HTTP/1.1
Host:
Authorization: Bearer JWT
Accept: */*
[
{
"originAsset": "nep141:eth-0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48.omft.near",
"destinationAsset": "nep141:17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1",
"depositAddress": "c6d7058a1ce152605ce97afcc3aeccb03bb3de9d43649bca815023f5931558c1",
"recipient": "somebody.near",
"status": "SUCCESS",
"createdAt": "2025-12-31T12:00:00.000Z",
"createdAtTimestamp": 1767182400,
"intentHashes": "GnGk38hvi92tTWDYMMS8CWYnVT4fixmfBrnqSErCDMTu",
"referral": "some-referral",
"amountInFormatted": "22.130108",
"amountOutFormatted": "22.113697",
"appFees": [
{
"fee": 50,
"recipient": "some.near"
},
{
"fee": 5,
"recipient": "somebody.near"
}
],
"nearTxHashes": [
"6XqqDwoaopgg39QsEiFGs9HfwP2Vum9tCCyqHDYXWBBH",
"EVcgKukwf38XsYcgvkEgiMPWR7qwLfLK5rsVtjgctPBn"
],
"originChainTxHashes": [
"0x9bcff372aee89b648c922b850573b22387c31d693079f5e37cd255814e2d615a"
],
"destinationChainTxHashes": [
"0x9bcff372aee89b648c922b850573b22387c31d693079f5e37cd255814e2d615a"
],
"amountIn": "22130108",
"amountInUsd": "22.1272",
"amountOut": "22113697",
"amountOutUsd": "22.1108",
"refundTo": "somebody.near"
}
]
Last updated