AcrossAcross Docs
IntroductionAPI Reference

List transfers

Lists transfers, newest first. Filters are repeatable and combine — values within one filter match any, separate filters must all match — and for reconciliation externalId matches your own id while txnRef matches any transaction in the transfer's lifecycle.

GET
/v1/transfers

Query Parameters

limit?integer

Page size.

Default50
Range1 <= value <= 100
cursor?string

Opaque cursor from the previous page's pagination.nextCursor. Page on this rather than on pagination.nextUrl -- see the note on that field.

fromSubmittedAt?string

Inclusive lower bound on submittedAt.

Formatdate-time
toSubmittedAt?string

Inclusive upper bound on submittedAt.

Formatdate-time
statusState?array<>

Coarse lifecycle state. Repeatable; matches any of the supplied values.

statusReason?array<>

Granular reason. Repeatable; matches any of the supplied values. Each reason belongs to exactly one state, so combining a reason with a conflicting statusState returns nothing.

orderId?array<string>

Order identifier. Repeatable -- supply it more than once to match any of the values (?orderId=a&orderId=b). Maximum 100 entries.

Itemsitems <= 100
externalId?array<string>

The integrator-supplied id echoed from the quote request. Repeatable -- supply it more than once to match any of the values (?externalId=a&externalId=b). Maximum 100 entries.

Itemsitems <= 100
depositor?array<string>

Account that paid the input. Repeatable -- supply it more than once to match any of the values (?depositor=a&depositor=b). Maximum 100 entries.

Itemsitems <= 100
recipient?array<string>

Account that receives the output. Repeatable -- supply it more than once to match any of the values (?recipient=a&recipient=b). Maximum 100 entries.

Itemsitems <= 100
txnRef?array<string>

Matches any transaction in the lifecycle ledger -- origin entry, settlement fill, destination delivery or refund. A hash can be pasted without knowing which role it played. Repeatable -- supply it more than once to match any of the values (?txnRef=a&txnRef=b). Maximum 100 entries.

Itemsitems <= 100
inputTokenAddress?array<string>

Token address on the origin side. Repeatable -- supply it more than once to match any of the values (?inputTokenAddress=a&inputTokenAddress=b). Maximum 100 entries.

Itemsitems <= 100
outputTokenAddress?array<string>

Token address on the destination side. Repeatable -- supply it more than once to match any of the values (?outputTokenAddress=a&outputTokenAddress=b). Maximum 100 entries.

Itemsitems <= 100
inputChainId?array<integer>

Chain id on the origin side. Repeatable -- supply it more than once to match any of the values (?inputChainId=a&inputChainId=b). Maximum 100 entries.

Itemsitems <= 100
outputChainId?array<integer>

Chain id on the destination side. Repeatable -- supply it more than once to match any of the values (?outputChainId=a&outputChainId=b). Maximum 100 entries.

Itemsitems <= 100

Response Body

application/json

application/json

application/json

curl -X GET "https://api.staging.across.to/v1/transfers?limit=5"
{
  "transfers": [
    {
      "orderId": "0x97a6ac2098d69b6f5ee153cea9ca164f1431185948e3ef76b05b60047dbf7e55",
      "externalId": "assurance:561cfae280b7aba63403:erc3009:exact_input:1788471069469",
      "status": {
        "state": "completed",
        "reason": "filled",
        "description": "The transfer completed and the funds were delivered.",
        "isTerminal": true,
        "finalized": true
      },
      "origin": {
        "input": {
          "token": {
            "type": "token",
            "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
            "symbol": "USDC",
            "name": "USD Coin",
            "decimals": 6,
            "chain": {
              "id": 1,
              "name": "mainnet",
              "displayName": "Mainnet",
              "logoUrl": "https://alexandria-blond.vercel.app/assets/chains/mainnet.svg"
            },
            "logoUrl": "https://alexandria-blond.vercel.app/assets/tokens/usdc.svg",
            "priceUsd": 0.9999236439138891,
            "priceUsdAt": "2026-09-03T21:30:00.000Z"
          },
          "amount": "99960"
        },
        "depositor": {
          "address": "0x9A8f92a830A5cB89a3816e3D267CB7791c16b04D",
          "chain": {
            "id": 1,
            "name": "mainnet",
            "displayName": "Mainnet",
            "logoUrl": "https://alexandria-blond.vercel.app/assets/chains/mainnet.svg"
          }
        }
      },
      "destination": {
        "output": {
          "token": {
            "type": "token",
            "address": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
            "symbol": "USDC",
            "name": "USD Coin",
            "decimals": 6,
            "chain": {
              "id": 42161,
              "name": "arbitrum-one",
              "displayName": "Arbitrum One",
              "logoUrl": "https://alexandria-blond.vercel.app/assets/chains/arbitrum.svg"
            },
            "logoUrl": "https://alexandria-blond.vercel.app/assets/tokens/usdc.svg",
            "priceUsd": 0.9999236439138891,
            "priceUsdAt": "2026-09-03T21:30:00.000Z"
          },
          "amount": "99910"
        },
        "recipient": {
          "address": "0x9A8f92a830A5cB89a3816e3D267CB7791c16b04D",
          "chain": {
            "id": 42161,
            "name": "arbitrum-one",
            "displayName": "Arbitrum One",
            "logoUrl": "https://alexandria-blond.vercel.app/assets/chains/arbitrum.svg"
          }
        }
      },
      "fees": {
        "totalUsd": 0.00004999618219568569
      },
      "submittedAt": "2026-09-03T21:31:18.940Z",
      "filledAt": "2026-09-03T21:31:53.000Z",
      "completedAt": "2026-09-03T21:31:53.648Z",
      "fillTimeMs": 34060,
      "sponsorshipUsd": "0.5",
      "funding": {
        "method": "erc3009"
      },
      "transactions": [
        {
          "type": "deposit",
          "transaction": {
            "txnRef": "0x03c1ce3513f44bb3366b43964e1a67a118721dadb1941a60b1ea622ec547d925",
            "chain": {
              "id": 1,
              "name": "mainnet",
              "displayName": "Mainnet",
              "logoUrl": "https://alexandria-blond.vercel.app/assets/chains/mainnet.svg"
            },
            "blockRef": 25899489,
            "blockTimestamp": "2026-09-03T21:31:47.000Z",
            "explorerUrl": "https://etherscan.io/tx/0x03c1ce3513f44bb3366b43964e1a67a118721dadb1941a60b1ea622ec547d925"
          }
        },
        {
          "type": "fill",
          "transaction": {
            "txnRef": "0x08a4066189536400df4546ebcac211d0a47c32e2decc81c560a0e4a50471e9fa",
            "chain": {
              "id": 42161,
              "name": "arbitrum-one",
              "displayName": "Arbitrum One",
              "logoUrl": "https://alexandria-blond.vercel.app/assets/chains/arbitrum.svg"
            },
            "blockRef": 501449833,
            "blockTimestamp": "2026-09-03T21:31:53.000Z",
            "explorerUrl": "https://arbiscan.io/tx/0x08a4066189536400df4546ebcac211d0a47c32e2decc81c560a0e4a50471e9fa"
          }
        }
      ],
      "quoted": {
        "sponsorshipUsd": "0.5",
        "origin": {
          "input": {
            "token": {
              "type": "token",
              "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
              "symbol": "USDC",
              "name": "USD Coin",
              "decimals": 6,
              "chain": {
                "id": 1,
                "name": "mainnet",
                "displayName": "Mainnet",
                "logoUrl": "https://alexandria-blond.vercel.app/assets/chains/mainnet.svg"
              },
              "logoUrl": "https://alexandria-blond.vercel.app/assets/tokens/usdc.svg",
              "priceUsd": 0.9999236439138891,
              "priceUsdAt": "2026-09-03T21:30:00.000Z"
            },
            "amount": "99960",
            "maxAmount": "99960"
          },
          "depositor": {
            "address": "0x9A8f92a830A5cB89a3816e3D267CB7791c16b04D",
            "chain": {
              "id": 1,
              "name": "mainnet",
              "displayName": "Mainnet",
              "logoUrl": "https://alexandria-blond.vercel.app/assets/chains/mainnet.svg"
            }
          }
        },
        "destination": {
          "output": {
            "token": {
              "type": "token",
              "address": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
              "symbol": "USDC",
              "name": "USD Coin",
              "decimals": 6,
              "chain": {
                "id": 42161,
                "name": "arbitrum-one",
                "displayName": "Arbitrum One",
                "logoUrl": "https://alexandria-blond.vercel.app/assets/chains/arbitrum.svg"
              },
              "logoUrl": "https://alexandria-blond.vercel.app/assets/tokens/usdc.svg",
              "priceUsd": 0.9999236439138891,
              "priceUsdAt": "2026-09-03T21:30:00.000Z"
            },
            "amount": null,
            "minAmount": "1"
          },
          "recipient": {
            "address": "0x9A8f92a830A5cB89a3816e3D267CB7791c16b04D",
            "chain": {
              "id": 42161,
              "name": "arbitrum-one",
              "displayName": "Arbitrum One",
              "logoUrl": "https://alexandria-blond.vercel.app/assets/chains/arbitrum.svg"
            }
          }
        },
        "fees": {
          "totalUsd": 0.09995136752198844
        },
        "fillTimeMs": 2000
      }
    },
    {
      "orderId": "0x3eb0cd9a50b26fbf0f96dd2d6db3d7b406621f0d032aca795b23c331f70cdc13",
      "status": {
        "state": "completed",
        "reason": "filled",
        "description": "The transfer completed and the funds were delivered.",
        "isTerminal": true,
        "finalized": true
      },
      "origin": {
        "input": {
          "token": {
            "type": "token",
            "address": "0x2100000000000000000000000000000000000000",
            "symbol": "USDC-PERPS",
            "name": "USDC (Perps)",
            "decimals": 8,
            "chain": {
              "id": 1337,
              "name": "hypercore",
              "displayName": "HyperCore",
              "logoUrl": "https://alexandria-blond.vercel.app/assets/chains/hypercore.svg"
            },
            "logoUrl": "https://alexandria-blond.vercel.app/assets/tokens/usdc.svg",
            "priceUsd": 0.9999132849329748,
            "priceUsdAt": "2026-09-03T20:30:00.000Z"
          },
          "amount": "100000000"
        },
        "depositor": {
          "address": "0x9A8f92a830A5cB89a3816e3D267CB7791c16b04D",
          "chain": {
            "id": 1337,
            "name": "hypercore",
            "displayName": "HyperCore",
            "logoUrl": "https://alexandria-blond.vercel.app/assets/chains/hypercore.svg"
          }
        }
      },
      "destination": {
        "output": {
          "token": {
            "type": "token",
            "address": "0x20C0000000000000000000000000000000000000",
            "symbol": "pathUSD",
            "name": "pathUSD",
            "decimals": 6,
            "chain": {
              "id": 4217,
              "name": "tempo",
              "displayName": "Tempo",
              "logoUrl": "https://alexandria-blond.vercel.app/assets/chains/tempo.svg"
            },
            "logoUrl": "https://alexandria-blond.vercel.app/assets/tokens/usdc.svg",
            "priceUsd": 0.9943899180448525,
            "priceUsdAt": "2026-09-03T20:30:00.000Z"
          },
          "amount": "999500"
        },
        "recipient": {
          "address": "0x9A8f92a830A5cB89a3816e3D267CB7791c16b04D",
          "chain": {
            "id": 4217,
            "name": "tempo",
            "displayName": "Tempo",
            "logoUrl": "https://alexandria-blond.vercel.app/assets/chains/tempo.svg"
          }
        }
      },
      "fees": {
        "totalUsd": 0.006020561847144612
      },
      "submittedAt": "2026-09-03T20:30:54.312Z",
      "filledAt": "2026-09-03T20:31:00.000Z",
      "completedAt": "2026-09-03T20:31:01.103Z",
      "fillTimeMs": 5688,
      "sponsorshipUsd": "0",
      "funding": {
        "method": "erc3009"
      },
      "transactions": [
        {
          "type": "origin_action",
          "transaction": {
            "txnRef": "0xdedf3650f0a704ece05804439e428702028f00368baa23be82a7e1a3afaaded7",
            "chain": {
              "id": 1337,
              "name": "hypercore",
              "displayName": "HyperCore",
              "logoUrl": "https://alexandria-blond.vercel.app/assets/chains/hypercore.svg"
            },
            "blockRef": null,
            "blockTimestamp": null,
            "explorerUrl": "https://app.hyperliquid.xyz/explorer/tx/0xdedf3650f0a704ece05804439e428702028f00368baa23be82a7e1a3afaaded7"
          }
        },
        {
          "type": "deposit",
          "transaction": {
            "txnRef": "0x3eee1b30ef8a58dd969b14f24d0179d9da2cecf4b893c7164927a30726d61021",
            "chain": {
              "id": 999,
              "name": "hyperevm",
              "displayName": "HyperEVM",
              "logoUrl": "https://alexandria-blond.vercel.app/assets/chains/hyperevm.svg"
            },
            "blockRef": 44948080,
            "blockTimestamp": "2026-09-03T20:30:59.000Z",
            "explorerUrl": "https://hyperevmscan.io/tx/0x3eee1b30ef8a58dd969b14f24d0179d9da2cecf4b893c7164927a30726d61021"
          }
        },
        {
          "type": "fill",
          "transaction": {
            "txnRef": "0xffe21f5be4b139229caa8dad2985d697bf58fce9e81c77af2365d5d458cef99d",
            "chain": {
              "id": 4217,
              "name": "tempo",
              "displayName": "Tempo",
              "logoUrl": "https://alexandria-blond.vercel.app/assets/chains/tempo.svg"
            },
            "blockRef": 37854589,
            "blockTimestamp": "2026-09-03T20:31:00.000Z",
            "explorerUrl": "https://blockscan.com/tx/0xffe21f5be4b139229caa8dad2985d697bf58fce9e81c77af2365d5d458cef99d"
          }
        }
      ],
      "quoted": {
        "sponsorshipUsd": null,
        "origin": {
          "input": {
            "token": {
              "type": "token",
              "address": "0xb88339CB7199b77E23DB6E890353E22632Ba630f",
              "symbol": "USDC",
              "name": "USD Coin",
              "decimals": 6,
              "chain": {
                "id": 999,
                "name": "hyperevm",
                "displayName": "HyperEVM",
                "logoUrl": "https://alexandria-blond.vercel.app/assets/chains/hyperevm.svg"
              },
              "logoUrl": "https://alexandria-blond.vercel.app/assets/tokens/usdc.svg",
              "priceUsd": 0.9999408911690082,
              "priceUsdAt": "2026-09-03T20:30:00.000Z"
            },
            "amount": "1000000",
            "maxAmount": "1000000"
          },
          "depositor": {
            "address": "0x9A8f92a830A5cB89a3816e3D267CB7791c16b04D",
            "chain": {
              "id": 999,
              "name": "hyperevm",
              "displayName": "HyperEVM",
              "logoUrl": "https://alexandria-blond.vercel.app/assets/chains/hyperevm.svg"
            }
          }
        },
        "destination": {
          "output": {
            "token": {
              "type": "token",
              "address": "0x20C0000000000000000000000000000000000000",
              "symbol": "pathUSD",
              "name": "pathUSD",
              "decimals": 6,
              "chain": {
                "id": 4217,
                "name": "tempo",
                "displayName": "Tempo",
                "logoUrl": "https://alexandria-blond.vercel.app/assets/chains/tempo.svg"
              },
              "logoUrl": "https://alexandria-blond.vercel.app/assets/tokens/usdc.svg",
              "priceUsd": 0.9943899180448525,
              "priceUsdAt": "2026-09-03T20:30:00.000Z"
            },
            "amount": null,
            "minAmount": "946349"
          },
          "recipient": {
            "address": "0x9A8f92a830A5cB89a3816e3D267CB7791c16b04D",
            "chain": {
              "id": 4217,
              "name": "tempo",
              "displayName": "Tempo",
              "logoUrl": "https://alexandria-blond.vercel.app/assets/chains/tempo.svg"
            }
          }
        },
        "fees": {
          "totalUsd": 0.058873380381146645
        },
        "fillTimeMs": 2000
      }
    }
  ],
  "pagination": {
    "nextCursor": "eyJzdWJtaXR0ZWRBdCI6MTc4ODQ2NzQ1NDMxMiwib3JkZXJJZCI6IjB4M2ViMGNkOWE1MGIyNmZiZjBmOTZkZDJkNmRiM2Q3YjQwNjYyMWYwZDAzMmFjYTc5NWIyM2MzMzFmNzBjZGMxMyJ9",
    "nextUrl": "/v1/transfers?limit=2&cursor=eyJzdWJtaXR0ZWRBdCI6MTc4ODQ2NzQ1NDMxMiwib3JkZXJJZCI6IjB4M2ViMGNkOWE1MGIyNmZiZjBmOTZkZDJkNmRiM2Q3YjQwNjYyMWYwZDAzMmFjYTc5NWIyM2MzMzFmNzBjZGMxMyJ9"
  }
}
{
  "error": {
    "type": "request",
    "code": "request.invalid_param",
    "message": "Request validation failed on query parameters",
    "param": "statusState",
    "requestId": "f6f0250f-8516-461b-8200-5855e5cb7d1f",
    "details": {
      "issues": [
        {
          "code": "invalid_value",
          "values": [
            "pending",
            "completed",
            "refunded",
            "failed"
          ],
          "path": [
            "statusState",
            0
          ],
          "message": "Invalid option: expected one of \"pending\"|\"completed\"|\"refunded\"|\"failed\""
        }
      ]
    }
  }
}
{
  "error": {
    "type": "request",
    "code": "not_found.transfer",
    "message": "string",
    "param": "string",
    "requestId": "string",
    "details": {}
  }
}

Execute a quote POST

Submits the credential that turns a quote into a transfer: either `authorization.signatures`, a map keyed by each signable `nextActions` id, or `authorization.txHash` for approval-funded quotes — sent before `expiresAt`. A 2xx means accepted, not arrived; follow it with `GET /v1/transfers/{orderId}`.

Get a transfer GET

Returns the current state of one transfer; `orderId` is the same value as the `quoteId` from `POST /v1/quotes`, so no lookup is needed. Gate anything irreversible on `status.finalized`.