Skip to main content
GET
/
intents
/
address
/
{address}
Get intent by address
curl --request GET \
  --url https://api.chainrails.io/api/v1/intents/address/{address} \
  --header 'Authorization: Bearer <token>'
{
  "id": 3,
  "client_id": "e1ee3675-cb26-4a76-8206-a84f86e85862",
  "sender": "0xdA3ECb2E5362295E2b802669dD47127A61d9Ce54",
  "initialAmount": "1000000",
  "fees": "10500",
  "totalAmount": "1010500",
  "tokenIn": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
  "tokenOut": "0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d",
  "intent_address": "0x4E60e01263E750eD9D087157e19D2480Fd86A900",
  "destination_intent_address": "0x5F70e12374E750fE0E087158f29E3591Ge97B011",
  "source_chain": "BASE_TESTNET",
  "destination_chain": "ARBITRUM_TESTNET",
  "recipient": "0xb79541Be080a59fdcE6C0b43219ba56c725eC65e",
  "refund_address": "0xb79541Be080a59fdcE6C0b43219ba56c725eC65e",
  "relayer": "",
  "coordinator": "0x989f47053F188778575113DcF39dB8960Fc450e2",
  "bridger": "0xa1c943058a631D5506eb7d96036eAbF6968e2338",
  "bridgeExtraData": "0x00000000000000000000000000000000000000000000000000000000000001f4",
  "intent_nonce": 4267684716645197,
  "intent_status": "FUNDED",
  "tx_hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "needs_relay": false,
  "relayer_claimed": false,
  "paymaster_used": false,
  "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"
}

Authorizations

​
Authorization
string
header
required

Enter your Chainrails API key as a Bearer token

Path Parameters

​
address
string
required

Intent contract address

Example:

"0x4E60e01263E750eD9D087157e19D2480Fd86A900"

Response

Intent retrieved successfully

​
id
number
Example:

3

​
client_id
string
Example:

"e1ee3675-cb26-4a76-8206-a84f86e85862"

​
sender
string
Example:

"0xdA3ECb2E5362295E2b802669dD47127A61d9Ce54"

​
initialAmount
string
Example:

"1000000"

​
fees
string
Example:

"10500"

​
totalAmount
string
Example:

"1010500"

​
tokenIn
string
Example:

"0x036CbD53842c5426634e7929541eC2318f3dCF7e"

​
tokenOut
string
Example:

"0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d"

​
intent_address
string
Example:

"0x4E60e01263E750eD9D087157e19D2480Fd86A900"

​
destination_intent_address
string
Example:

"0x5F70e12374E750fE0E087158f29E3591Ge97B011"

​
source_chain
string
Example:

"BASE_TESTNET"

​
destination_chain
string
Example:

"ARBITRUM_TESTNET"

​
recipient
string
Example:

"0xb79541Be080a59fdcE6C0b43219ba56c725eC65e"

​
refund_address
string
Example:

"0xb79541Be080a59fdcE6C0b43219ba56c725eC65e"

​
relayer
string
Example:

""

​
coordinator
string
Example:

"0x989f47053F188778575113DcF39dB8960Fc450e2"

​
bridger
string
Example:

"0xa1c943058a631D5506eb7d96036eAbF6968e2338"

​
bridgeExtraData
string
Example:

"0x00000000000000000000000000000000000000000000000000000000000001f4"

​
intent_nonce
number
Example:

4267684716645197

​
intent_status
enum<string>
Available options:
PENDING,
FUNDED,
INITIATED,
COMPLETED,
EXPIRED
Example:

"FUNDED"

​
tx_hash
string | null
Example:

"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"

​
needs_relay
boolean
Example:

false

​
relayer_claimed
boolean
Example:

false

​
paymaster_used
boolean
Example:

false

​
mode
enum<string>
Available options:
test,
live
Example:

"test"

​
expires_at
string<date-time>
Example:

"2025-12-13T03:31:23.000Z"

​
metadata
object
Example:
{ "orderId": "12345" }
​
created_at
string<date-time>
Example:

"2025-12-13T02:31:23.390Z"

​
updated_at
string<date-time>
Example:

"2025-12-13T02:33:15.120Z"