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
numberOfTransactionsnumber · min: 1 · max: 1000Optional

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

lastDepositAddressstringOptional

Last known deposit address. Retrieve one page first, then specify the direction and use the last deposit address you received (from the top or bottom, depending on the direction you want to go) to fetch the next page. Repeat until the endpoint returns an empty array to get all results.

directionstring · enumOptional

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

Possible values:
searchstringOptional

Search by deposit address, recipient, or intent hashes.

fromChainIdstring · enumOptional

Filter by origin chain ID.

Possible values:
fromTokenIdstringOptional

Filter by origin token ID. Overrides fromChainId.

toChainIdstring · enumOptional

Filter by destination chain ID.

Possible values:
toTokenIdstringOptional

Filter by destination token ID. Overrides toChainId. Overrides fromTokenId.

referralstringOptional

Filter by referral.

affiliatestringOptional

Filter by an affiliate 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.

minUsdPricenumber | nullableOptional

Filter by minimum USD price for both input and output amounts.

maxUsdPricenumber | nullableOptional

Filter by maximum USD price for both input and output amounts.

endTimestampstring | nullableOptional

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

endTimestampUnixnumber | nullableOptional

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

startTimestampstring | nullableOptional

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

startTimestampUnixnumber | nullableOptional

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

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"
  }
]

Get paginated transactions

get
Authorizations
Query parameters
pagenumber · min: 1Optional

Page number. Default: 1. Min: 1.

perPagenumber · min: 1 · max: 1000Optional

Number of transactions per page. Default: 50. Max: 1000. Min: 1.

searchstringOptional

Search by deposit address, recipient, or intent hashes.

fromChainIdstring · enumOptional

Filter by origin chain ID.

Possible values:
fromTokenIdstringOptional

Filter by origin token ID. Overrides fromChainId.

toChainIdstring · enumOptional

Filter by destination chain ID.

Possible values:
toTokenIdstringOptional

Filter by destination token ID. Overrides toChainId. Overrides fromTokenId.

referralstringOptional

Filter by referral.

affiliatestringOptional

Filter by an affiliate 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.

minUsdPricenumber | nullableOptional

Filter by minimum USD price for both input and output amounts.

maxUsdPricenumber | nullableOptional

Filter by maximum USD price for both input and output amounts.

endTimestampstring | nullableOptional

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

endTimestampUnixnumber | nullableOptional

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

startTimestampstring | nullableOptional

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

startTimestampUnixnumber | nullableOptional

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

Responses
200

Transactions

application/json
get
GET /api/v0/transactions-pages HTTP/1.1
Host: 
Authorization: Bearer JWT
Accept: */*

{
  "data": [
    {
      "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"
    }
  ],
  "totalPages": 50,
  "page": 1,
  "perPage": 50,
  "total": 2500,
  "nextPage": 2,
  "prevPage": null
}

Last updated