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. 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:
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

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 transaction pages

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:
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

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