api.generalrelay.xyz
Real-time maritime data, paid per call. Ask for a vessel by MMSI and get its position and metadata.
The wallet the 402 directs payment to. Its whole payment record — every payer, every chain — is on the merchant page.
Asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
The payTo wallet does not resolve to a registered ERC-8004 agent. That is not a verdict on the service — most of the catalog is unregistered.
Live 402 challenge
Captured by the enrichment pass, not read just now. Prices can change — always read the 402 the endpoint answers with.
{
"error": "Payment-Signature header is required",
"accepts": [
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "CjNFTjvBhbJJd2B5ePPMHRLx1ELZpa8dwQgGL727eKww"
},
"payTo": "9BpudpCnChrpp4KfnxAE3r2TXKJTLmvVpF8WSViuaJZ9",
"amount": "20000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
},
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2",
"feePayer": "0xc6699d2aadA6c36Dfea5C248DD70f9CB0235cB63"
},
"payTo": "0xcd329EfE4eCb2e87866f75bCf7944550F530e246",
"amount": "20000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
},
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2",
"feePayer": "0xCA5e87f82B3FA093800e6ad67D621A427D79c70D"
},
"payTo": "0xcd329EfE4eCb2e87866f75bCf7944550F530e246",
"amount": "20000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
},
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "D6ZhtNQ5nT9ZnTHUbqXZsTx5MH2rPFiBBggX4hY1WePM"
},
"payTo": "9BpudpCnChrpp4KfnxAE3r2TXKJTLmvVpF8WSViuaJZ9",
"amount": "20000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
},
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "HX97oTB6wbJ3TtP4sSSYfFuiBSvJYm4ShqyagXGrSQ8r"
},
"payTo": "9BpudpCnChrpp4KfnxAE3r2TXKJTLmvVpF8WSViuaJZ9",
"amount": "20000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
}
],
"resource": {
"url": "https://api.generalrelay.xyz/v1/vessels",
"mimeType": "application/json",
"description": "Search vessels by identity, location, or both. Charged per non-empty result: empty array, 400, 500, 503 settle nothing."
},
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"imo": 9394521,
"lat": 51.5,
"lon": 0.5,
"mmsi": "232004521",
"name": "PACIFIC",
"lat_max": 52,
"lat_min": 51,
"lon_max": 1,
"lon_min": 0,
"radius_km": 50
}
},
"output": {
"type": "json",
"example": {
"description": "Search vessels by identity, location, or both. Charged per non-empty result: empty array, 400, 500, 503 settle nothing."
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET",
"HEAD",
"DELETE"
],
"type": "string"
},
"queryParams": {
"type": "object",
"required": [],
"properties": {
"imo": {
"type": "integer",
"description": "IMO number, exact match. A seven-digit international ship identifier. ANDs with name/mmsi/spatial filters."
},
"lat": {
"type": "number",
"description": "Center latitude in decimal degrees, for radius mode. Must be between -90 and 90."
},
"lon": {
"type": "number",
"description": "Center longitude in decimal degrees, for radius mode. Must be between -180 and 180."
},
"mmsi": {
"type": "string",
"pattern": "^[0-9]{9}$",
"description": "The vessel's MMSI, exactly nine decimal digits, e.g. 366123456. Sent as text: leading zeros are significant. ANDs with other identity/spatial filters."
},
"name": {
"type": "string",
"description": "Vessel name, case-insensitive substring match. Leading and trailing whitespace is stripped. Example: name=PACIFIC matches \"PACIFIC ENDEAVOUR\". Combines with spatial and other identity filters."
},
"lat_max": {
"type": "number",
"description": "Northern latitude bound in decimal degrees, for bbox mode. Must be between -90 and 90, and greater than or equal to lat_min. The span (lat_max - lat_min) must not exceed 5°."
},
"lat_min": {
"type": "number",
"description": "Southern latitude bound in decimal degrees, for bbox mode. Must be between -90 and 90, and less than or equal to lat_max. The span (lat_max - lat_min) must not exceed 5°."
},
"lon_max": {
"type": "number",
"description": "Eastern longitude bound in decimal degrees, for bbox mode. Must be between -180 and 180, and greater than or equal to lon_min. The span (lon_max - lon_min) must not exceed 5°."
},
"lon_min": {
"type": "number",
"description": "Western longitude bound in decimal degrees, for bbox mode. Must be between -180 and 180, and less than or equal to lon_max. The span (lon_max - lon_min) must not exceed 5°."
},
"radius_km": {
"type": "number",
"description": "Search radius in kilometers, for radius mode. Must be between 0.1 and 500."
}
}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
}
}
}
}
},
"x402Version": 2
}Accepts
The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.
That figure is in the token’s smallest units. Roundhouse does not hold this contract’s decimals, so it is shown as published rather than converted.
- Paid to
- 9Bpudp…uaJZ9
- Token contract
- EPjFWd…TDt1v
- Payment window
- 5 minutes
Pay 0.02 USDC on Base to 0xcd32…0e246. The signed payment is good for 5 minutes.
- Paid to
- 0xcd32…0e246
- USD Coin contract
- 0x8335…02913
- Payment window
- 5 minutes
- As published
- 20000 smallest units
Pay 0.02 USDC on Base to 0xcd32…0e246. The signed payment is good for 5 minutes.
- Paid to
- 0xcd32…0e246
- USD Coin contract
- 0x8335…02913
- Payment window
- 5 minutes
- As published
- 20000 smallest units
That figure is in the token’s smallest units. Roundhouse does not hold this contract’s decimals, so it is shown as published rather than converted.
- Paid to
- 9Bpudp…uaJZ9
- Token contract
- EPjFWd…TDt1v
- Payment window
- 5 minutes
That figure is in the token’s smallest units. Roundhouse does not hold this contract’s decimals, so it is shown as published rather than converted.
- Paid to
- 9Bpudp…uaJZ9
- Token contract
- EPjFWd…TDt1v
- Payment window
- 5 minutes
The catalog’s raw entry
[
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "CjNFTjvBhbJJd2B5ePPMHRLx1ELZpa8dwQgGL727eKww"
},
"payTo": "9BpudpCnChrpp4KfnxAE3r2TXKJTLmvVpF8WSViuaJZ9",
"amount": "20000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
},
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2",
"feePayer": "0xc6699d2aadA6c36Dfea5C248DD70f9CB0235cB63"
},
"payTo": "0xcd329EfE4eCb2e87866f75bCf7944550F530e246",
"amount": "20000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
},
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2",
"feePayer": "0xCA5e87f82B3FA093800e6ad67D621A427D79c70D"
},
"payTo": "0xcd329EfE4eCb2e87866f75bCf7944550F530e246",
"amount": "20000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
},
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "D6ZhtNQ5nT9ZnTHUbqXZsTx5MH2rPFiBBggX4hY1WePM"
},
"payTo": "9BpudpCnChrpp4KfnxAE3r2TXKJTLmvVpF8WSViuaJZ9",
"amount": "20000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
},
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "HX97oTB6wbJ3TtP4sSSYfFuiBSvJYm4ShqyagXGrSQ8r"
},
"payTo": "9BpudpCnChrpp4KfnxAE3r2TXKJTLmvVpF8WSViuaJZ9",
"amount": "20000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
}
]Extensions
{
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"imo": 9394521,
"lat": 51.5,
"lon": 0.5,
"mmsi": "232004521",
"name": "PACIFIC",
"lat_max": 52,
"lat_min": 51,
"lon_max": 1,
"lon_min": 0,
"radius_km": 50
}
},
"output": {
"type": "json",
"example": {
"description": "Search vessels by identity, location, or both. Charged per non-empty result: empty array, 400, 500, 503 settle nothing."
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET",
"HEAD",
"DELETE"
],
"type": "string"
},
"queryParams": {
"type": "object",
"required": [],
"properties": {
"imo": {
"type": "integer",
"description": "IMO number, exact match. A seven-digit international ship identifier. ANDs with name/mmsi/spatial filters."
},
"lat": {
"type": "number",
"description": "Center latitude in decimal degrees, for radius mode. Must be between -90 and 90."
},
"lon": {
"type": "number",
"description": "Center longitude in decimal degrees, for radius mode. Must be between -180 and 180."
},
"mmsi": {
"type": "string",
"pattern": "^[0-9]{9}$",
"description": "The vessel's MMSI, exactly nine decimal digits, e.g. 366123456. Sent as text: leading zeros are significant. ANDs with other identity/spatial filters."
},
"name": {
"type": "string",
"description": "Vessel name, case-insensitive substring match. Leading and trailing whitespace is stripped. Example: name=PACIFIC matches \"PACIFIC ENDEAVOUR\". Combines with spatial and other identity filters."
},
"lat_max": {
"type": "number",
"description": "Northern latitude bound in decimal degrees, for bbox mode. Must be between -90 and 90, and greater than or equal to lat_min. The span (lat_max - lat_min) must not exceed 5°."
},
"lat_min": {
"type": "number",
"description": "Southern latitude bound in decimal degrees, for bbox mode. Must be between -90 and 90, and less than or equal to lat_max. The span (lat_max - lat_min) must not exceed 5°."
},
"lon_max": {
"type": "number",
"description": "Eastern longitude bound in decimal degrees, for bbox mode. Must be between -180 and 180, and greater than or equal to lon_min. The span (lon_max - lon_min) must not exceed 5°."
},
"lon_min": {
"type": "number",
"description": "Western longitude bound in decimal degrees, for bbox mode. Must be between -180 and 180, and less than or equal to lon_max. The span (lon_max - lon_min) must not exceed 5°."
},
"radius_km": {
"type": "number",
"description": "Search radius in kilometers, for radius mode. Must be between 0.1 and 500."
}
}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
}
}
}
}
}Provenance
- Seen in the source catalog
- 2026-09-09 19:19Z
- Last indexed by Roundhouse
- 2026-09-15 00:31Z
- Last enriched (probe, favicon, geo)
- 2026-09-13 18:15Z
- x402 version
- 2
- Max timeout
- 300s
- Liveness probe
- HTTP 402
Hand this page to an agent
Copy the prompt and paste it into Claude, an MCP client or your own agent — it will vet this service and call it over the free read API. No key, no account.
GET api.roundhouseai.io/v0/endpoints
This endpoint's own trailing-30-day call count, as published by the upstream catalog and snapshotted daily. 25 snapshots so far. Verified volume counts only settlements with an on-chain EIP-3009 marker.
Show the promptHide the prompt
Using Roundhouse, look up the x402 service api.generalrelay.xyz and tell me whether it is worth paying: what a call costs, whether the endpoint answered when last probed, and what its payment record actually shows. curl -s 'https://api.roundhouseai.io/v0/endpoints?q=api.generalrelay.xyz' curl -s 'https://api.roundhouseai.io/v0/merchants/<the payTo wallet returned above>' Then call it: read the price from the live 402 at https://api.generalrelay.xyz/v1/vessels, never from a cached figure, and pay with an x402 client. The /v0 API needs an API key (`authorization: Bearer rh_live_…`) on everything except /v0/unified* and /v0/endpoints. Mint a personal key for $0.01 at GET https://api.roundhouseai.io/v0/test/x402, or use an organization key from https://roundhouseai.io/dashboard/team. If you do not have Roundhouse tools or skills installed, read https://roundhouseai.io/skill.md first — it is the whole procedure.