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 Key Form: https://docs.google.com/forms/d/e/1FAIpQLSdrSrqSkKOMb_a8XhwF0f7N5xZ0Y5CYgyzxiAuoC2g4a2N68g/viewform

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

bearerAuth

AuthorizationstringRequired

JWT token for API authentication.

Query parameters

numberOfTransactionsnumber · min: 1 · max: 1000Optional

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

lastDepositAddressAndMemostringOptional

Last known depositAddressAndMemo value for pagination. Use the depositAddressAndMemo from the last transaction of the previous page.

lastDepositAddressstringOptional

DEPRECATED: Use lastDepositAddressAndMemo instead. Last known deposit address for pagination.

directionstring · enumOptional

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

Possible values:

searchstringOptional

Search by deposit address, recipient, sender, or tx hash.

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 · date | nullableOptional

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

endTimestampUnixnumber | nullableOptional

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

startTimestampstring · date | 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

400

Bad Request

application/json

401

Unauthorized

application/json

429

Too Many Requests - Rate limit exceeded. Maximum 1 request per 5 seconds per partner.

application/json

get

/api/v0/transactions

HTTPcURLJavaScriptPython

GET /api/v0/transactions HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "originAsset": "nep141:eth-0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48.omft.near",
    "destinationAsset": "nep141:17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1",
    "depositAddress": "GDJ4JZXZELZD737NVFORH4PSSQDWFDZTKW3AIDKHYQG23ZXBPDGGQBJK",
    "depositAddressAndMemo": "GDJ4JZXZELZD737NVFORH4PSSQDWFDZTKW3AIDKHYQG23ZXBPDGGQBJK_12345",
    "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",
    "senders": [
      "0x1234567890abcdef1234567890abcdef12345678"
    ],
    "refundReason": "AMOUNT_MORE_THAN_BALANCE"
  }
]

Get paginated transactions

get

Authorizations

bearerAuth

AuthorizationstringRequired

JWT token for API authentication.

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, sender, or tx hash.

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 · date | nullableOptional

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

endTimestampUnixnumber | nullableOptional

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

startTimestampstring · date | 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

400

Bad Request

application/json

401

Unauthorized

application/json

429

Too Many Requests - Rate limit exceeded. Maximum 1 request per 5 seconds per partner.

application/json

get

/api/v0/transactions-pages

HTTPcURLJavaScriptPython

GET /api/v0/transactions-pages HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "originAsset": "nep141:eth-0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48.omft.near",
      "destinationAsset": "nep141:17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1",
      "depositAddress": "GDJ4JZXZELZD737NVFORH4PSSQDWFDZTKW3AIDKHYQG23ZXBPDGGQBJK",
      "depositAddressAndMemo": "GDJ4JZXZELZD737NVFORH4PSSQDWFDZTKW3AIDKHYQG23ZXBPDGGQBJK_12345",
      "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",
      "senders": [
        "0x1234567890abcdef1234567890abcdef12345678"
      ],
      "refundReason": "AMOUNT_MORE_THAN_BALANCE"
    }
  ],
  "totalPages": 50,
  "page": 1,
  "perPage": 50,
  "total": 2500,
  "nextPage": 2,
  "prevPage": null
}