Skip to main content

​
ClawMerchants data feeds

The ClawMerchants endpoint provides access to 15 live data feeds covering DeFi yields, token anomalies, security intelligence, market data, and developer trends.

​
List available feeds

GET /api/clawmerchants
No authentication required. Returns all available data feeds with their upstream endpoints.

​
Response (200)

{
  "feeds": [
    {
      "id": "defi-yields",
      "endpoint": "https://clawmerchants.com/v1/data/defi-yields-live",
      "preview": "https://clawmerchants.com/v1/preview/defi-yields"
    }
  ],
  "total": 15,
  "docs": "https://clawmerchants.com/openapi.json"
}
FieldTypeDescription
feedsarrayList of available data feeds
feeds[].idstringFeed identifier used in the feed query parameter
feeds[].endpointstringUpstream ClawMerchants endpoint URL
feeds[].previewstringFree preview URL for the feed
totalnumberTotal number of available feeds
docsstringURL to the ClawMerchants OpenAPI specification

​
Fetch a feed

GET /api/clawmerchants?feed={feed_id}
No authentication required. Fetches data from a specific feed. Paid feeds may return a 402 response with an x402 payment challenge.

​
Query parameters

ParameterTypeRequiredDescription
feedstringYesFeed identifier (see available feeds)
previewstringNoSet to true to fetch from the free preview endpoint instead of the live feed

​
Response (200)

{
  "feed": "defi-yields",
  "source": "clawmerchants",
  "data": {}
}
FieldTypeDescription
feedstringFeed identifier that was requested
sourcestringAlways clawmerchants
dataobjectFeed payload. Structure varies by feed — see available feeds for details.

​
Response (402)

Returned when the upstream feed requires payment. The response includes an x402 payment challenge. 
{
  "status": "payment_required",
  "feed": "defi-yields",
  "challenge": {},
  "hint": "Use x402 or MPP to pay for this data feed"
}
FieldTypeDescription
statusstringAlways payment_required
feedstringFeed identifier that was requested
challengeobjectx402 payment challenge from the upstream provider
hintstringHuman-readable payment guidance

​
Error responses

StatusErrorDescription
400Unknown feedThe feed parameter does not match any available feed. The response includes an available array of valid feed identifiers.
500Feed fetch failedAn error occurred while fetching from the upstream ClawMerchants endpoint. The message field contains the error detail.

​
Unknown feed response

{
  "error": "Unknown feed",
  "available": ["defi-yields", "token-anomalies", "security-intel", "..."]
}

​
Fetch failure response

{
  "error": "Feed fetch failed",
  "message": "Request timed out"
}
Upstream requests use a 10-second timeout. If the ClawMerchants service is slow or unavailable, you will receive a 500 error with the timeout message.

​
Available feeds

Feed IDUpstream pathCategory
defi-yields/v1/data/defi-yields-liveDeFi
token-anomalies/v1/data/token-anomalies-liveDeFi
security-intel/v1/data/security-intel-liveSecurity
market-data/v1/data/market-data-liveMarket
whale-alert/v1/data/whale-alert-liveMarket
gas-prices/v1/data/gas-prices-liveMarket
defi-tvl/v1/data/defi-protocol-tvl-liveDeFi
stablecoin-flows/v1/data/stablecoin-flows-liveDeFi
dex-volume/v1/data/dex-volume-liveMarket
liquidations/v1/data/liquidations-liveDeFi
ai-ecosystem/v1/data/ai-ecosystem-intel-liveIntelligence
crypto-sentiment/v1/data/crypto-sentiment-liveMarket
hn-trending/v1/data/hn-top-stories-liveDeveloper
github-trending/v1/data/github-trending-liveDeveloper
hf-papers/v1/data/hf-papers-liveDeveloper

​
Examples

​
List all feeds

curl https://agentbot.raveculture.xyz/api/clawmerchants

​
Fetch a live feed

curl "https://agentbot.raveculture.xyz/api/clawmerchants?feed=defi-yields"

​
Fetch a preview

curl "https://agentbot.raveculture.xyz/api/clawmerchants?feed=security-intel&preview=true"