v8

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-014667228.9 KB

Intents

Get intent by address

Retrieves an intent using its contract address

get/intents/address/{address}

Path parameters

addressstring required

Example:0x4E60e01263E750eD9D087157e19D2480Fd86A900

Intent contract address

Response

Intent retrieved successfully

idnumber

client_idstring

senderstring

initialAmountstring

fees_in_usdstring

app_fee_in_usdstring

total_amount_in_usdstring

total_amount_in_asset_tokenstring

fees_in_asset_tokenstring

app_fee_in_asset_tokenstring

asset_token_symbolstring

asset_token_decimalsnumber

slippagestring

tokenInstring

tokenOutstring

intent_addressstring

Solana: intent PDA — show to users for QR/Send; transfer tokenIn here (wallet derives deposit ATA). EVM/Starknet: contract address.

deposit_token_accountstring

Solana only: ATA(mint, intent PDA). Indexer and recovery only — do not use for QR/Send; fund via intent_address instead.

destination_intent_addressstring

source_chainstring

destination_chainstring

recipientstring

refund_addressstring

relayerstring

coordinatorstring

bridgerstring

bridgeExtraDatastring

intent_noncenumber

intent_status'PENDING' | 'FUNDED' | 'INITIATED' | 'COMPLETED' | 'EXPIRED'

tx_hashstring nullable

needs_relayboolean

relayer_claimedboolean

paymaster_usedboolean

mode'test' | 'live'

expires_atstring date-time

metadataobject

created_atstring date-time

updated_atstring date-time

Example response

{
  "id": 3,
  "client_id": "e1ee3675-cb26-4a76-8206-a84f86e85862",
  "sender": "0xdA3ECb2E5362295E2b802669dD47127A61d9Ce54",
  "initialAmount": "1000000",
  "fees_in_usd": "10500",
  "app_fee_in_usd": "1000",
  "total_amount_in_usd": "1010500",
  "total_amount_in_asset_token": "1000500",
  "fees_in_asset_token": "500",
  "app_fee_in_asset_token": "0",
  "asset_token_symbol": "USDC",
  "asset_token_decimals": 6,
  "slippage": "0.5",
  "tokenIn": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
  "tokenOut": "0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d",
  "intent_address": "0x4E60e01263E750eD9D087157e19D2480Fd86A900",
  "deposit_token_account": "DX8aM33XqJqZqZqZqJqZqZqZqJqZqZqZqJqZqZqZqJqZ",
  "destination_intent_address": "0x5F70e12374E750fE0E087158f29E3591Ge97B011",
  "source_chain": "BASE_TESTNET",
  "destination_chain": "ARBITRUM_TESTNET",
  "recipient": "0xb79541Be080a59fdcE6C0b43219ba56c725eC65e",
  "refund_address": "0xb79541Be080a59fdcE6C0b43219ba56c725eC65e",
  "coordinator": "0x989f47053F188778575113DcF39dB8960Fc450e2",
  "bridger": "0xa1c943058a631D5506eb7d96036eAbF6968e2338",
  "bridgeExtraData": "0x00000000000000000000000000000000000000000000000000000000000001f4",
  "intent_nonce": 4267684716645197,
  "intent_status": "FUNDED",
  "tx_hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "mode": "test",
  "expires_at": "2025-12-13T03:31:23.000Z",
  "metadata": {
    "orderId": "12345"
  },
  "created_at": "2025-12-13T02:31:23.390Z",
  "updated_at": "2025-12-13T02:33:15.120Z"
}