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

API Specification (v0)

Auto-generate clients using our OpenAPI spec.

Authentication: It is mandatory to obtain a JWT token and use it for all requests.

API Endpoints

Get transactions

get
Authorizations
Query parameters
lastDepositAddressstringOptional

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

directionstring · enumOptional

Direction of pagination. 'next' - get older transactions, 'prev' - get newer transactions. Default: 'next'.

Possible values:
numberOfTransactionsnumber | nullableOptional

The number of transactions to return. Default: 50. Max: 1000

searchstringOptional

Search by deposit address, recipient, or intent hashes

fromChainIdstring · enumOptional

Filter by origin chain ID

Possible values:
toChainIdstring · enumOptional

Filter by destination chain ID

Possible values:
referralstringOptional

Filter by referral

affiliatestringOptional

Filter by affiliate that is stored in the fees

statusesstringOptional

Filter by comma-separated statuses. Allowed values: FAILED, INCOMPLETE_DEPOSIT, PENDING_DEPOSIT, PROCESSING, REFUNDED, SUCCESS. Default: FAILED, PROCESSING, REFUNDED, SUCCESS

showTestTxsstringOptional

Show transactions from test accounts and with test-related referrals

startTimestampstring | nullableOptional

Filter by start timestamp (inclusive). Use ISO 8601 format

startTimestampUnixnumber | nullableOptional

Filter by start timestamp (inclusive). Use Unix timestamp

endTimestampstring | nullableOptional

Filter by end timestamp (non-inclusive). Use ISO 8601 format

endTimestampUnixnumber | nullableOptional

Filter by end timestamp (non-inclusive). Use Unix timestamp

lastRelatedReceiptIdstringOptional

Last related receipt ID. Currently ignored

Responses
200
Transactions
application/json
get
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