NEURA API - Complete API Documentation for LLMs ======================================================================== API Base URL: http://api.neura402.xyz This API provides access to Codex blockchain data including tokens, balances, networks, and price information. All endpoints require payment via X402 protocol. PAYMENT INFORMATION: -------------------- - Payment Protocol: X402 - Payment Network (Root Routes): Solana (default) - Payment Network (Solana Routes): Solana - Payment Network (Base Routes): Base - Price per Request: $0.0004 - Facilitator URL: https://facilitator.payai.network ROUTE PREFIXES: --------------- 1. Root routes: http://api.neura402.xyz/* (defaults to Solana payments) 2. Solana routes: http://api.neura402.xyz/solana/* (explicit Solana payments) 3. Base routes: http://api.neura402.xyz/base/* (explicit Base payments) AVAILABLE ENDPOINTS: ==================== ROOT ROUTES (http://api.neura402.xyz/): ----------- Default payment network: Solana GET /token/* ============ Price: $0.0004 Network: solana Description: Get detailed token information including metadata, social links, market data, and network information Input Schema: Method: GET Output Schema: Type: object Properties: success: Type: boolean data: Type: object Type: object Properties: address: Type: string symbol: Type: string name: Type: string decimals: Type: number totalSupply: Type: string networkId: Type: number networkName: Type: string logoUrl: Type: string description: Type: string website: Type: string twitter: Type: string discord: Type: string telegram: Type: string github: Type: string coingeckoId: Type: string marketCap: Type: number volume24h: Type: number priceChange24h: Type: number lastUpdated: Type: string id: Type: string cmcId: Type: number createBlockNumber: Type: number createTransactionHash: Type: string createdAt: Type: number creatorAddress: Type: string freezable: Type: string isFreezableValid: Type: boolean isMintableValid: Type: boolean isScam: Type: boolean mintable: Type: string exchanges: Type: array info: Type: object launchpad: Type: object socialLinks: Type: object error: Type: string timestamp: Type: string POST /balances ============== Price: $0.0004 Network: solana Description: Get token balances for a wallet address across specified networks Input Schema: Method: POST Body Type: json Body Fields: walletAddress: string networks: array Output Schema: Type: object Properties: success: Type: boolean data: Type: object Description: Balance data organized by network error: Type: string timestamp: Type: string GET /networks ============= Price: $0.0004 Network: solana Description: Get information about all supported blockchain networks including their IDs, names, symbols, and chain IDs Input Schema: Method: GET Output Schema: Type: object Properties: success: Type: boolean data: Type: object Type: object Properties: networks: Type: array Items: Type: object Properties: id: Type: number name: Type: string symbol: Type: string chainId: Type: number isActive: Type: boolean lastUpdated: Type: string total: Type: number lastUpdated: Type: string error: Type: string timestamp: Type: string GET /tokens/* ============= Price: $0.0004 Network: solana Description: Search for tokens by name, symbol, or address across all supported networks, or get top 10 token holders Input Schema: Method: GET Query Parameters: q: string limit: string Output Schema: Type: object Properties: success: Type: boolean data: Type: object Type: object Properties: tokens: Type: array Items: Type: object Properties: id: Type: string address: Type: string symbol: Type: string name: Type: string decimals: Type: number networkId: Type: number networkName: Type: string logoUrl: Type: string description: Type: string website: Type: string twitter: Type: string discord: Type: string telegram: Type: string github: Type: string coingeckoId: Type: string marketCap: Type: number volume24h: Type: number priceChange24h: Type: number lastUpdated: Type: string total: Type: number query: Type: string lastUpdated: Type: string holders: Type: array Items: Type: object Properties: address: Type: string balance: Type: string percentage: Type: number rank: Type: number tokenId: Type: string totalHolders: Type: number error: Type: string timestamp: Type: string GET /bars ========= Price: $0.0004 Network: solana Description: Get historical price bars (OHLCV data) for a specific token symbol over a time range Input Schema: Method: GET Query Parameters: symbol: string from: string to: string resolution: string removeLeadingNullValues: string Output Schema: Type: object Properties: success: Type: boolean data: Type: object Type: object Properties: bars: Type: array Items: Type: object Properties: t: Type: number Description: timestamp c: Type: number Description: close h: Type: number Description: high l: Type: number Description: low o: Type: number Description: open volume: Type: number symbol: Type: string resolution: Type: string from: Type: number to: Type: number lastUpdated: Type: string error: Type: string timestamp: Type: string GET /launchpads/new =================== Price: $0.0004 Network: solana Description: Get new launchpad tokens that are not completed and not migrated, sorted by creation date (newest first) Input Schema: Method: GET Output Schema: Type: object Properties: success: Type: boolean data: Type: object Type: object Properties: filterTokens: Type: object Type: object Properties: results: Type: array Items: Type: object Properties: createdAt: Type: number marketCap: Type: number priceUSD: Type: number token: Type: object Type: object Properties: name: Type: string symbol: Type: string address: Type: string networkId: Type: number launchpad: Type: object Type: object Properties: graduationPercent: Type: number launchpadName: Type: string launchpadProtocol: Type: string migrated: Type: boolean completed: Type: boolean completedAt: Type: string error: Type: string timestamp: Type: string GET /launchpads/completing ========================== Price: $0.0004 Network: solana Description: Get launchpad tokens that are 80-100% complete but not yet fully completed or migrated, sorted by graduation percent (highest first) Input Schema: Method: GET Output Schema: Type: object Properties: success: Type: boolean data: Type: object Type: object Properties: filterTokens: Type: object Type: object Properties: results: Type: array Items: Type: object Properties: createdAt: Type: number marketCap: Type: number priceUSD: Type: number token: Type: object Type: object Properties: name: Type: string symbol: Type: string address: Type: string networkId: Type: number launchpad: Type: object Type: object Properties: graduationPercent: Type: number launchpadName: Type: string launchpadProtocol: Type: string migrated: Type: boolean completed: Type: boolean completedAt: Type: string error: Type: string timestamp: Type: string GET /launchpads/completed ========================= Price: $0.0004 Network: solana Description: Get completed launchpad tokens that have been migrated and reached 100% graduation, sorted by migration date (newest first) Input Schema: Method: GET Output Schema: Type: object Properties: success: Type: boolean data: Type: object Type: object Properties: filterTokens: Type: object Type: object Properties: results: Type: array Items: Type: object Properties: createdAt: Type: number marketCap: Type: number priceUSD: Type: number token: Type: object Type: object Properties: name: Type: string symbol: Type: string address: Type: string networkId: Type: number launchpad: Type: object Type: object Properties: graduationPercent: Type: number launchpadName: Type: string launchpadProtocol: Type: string migrated: Type: boolean completed: Type: boolean completedAt: Type: string error: Type: string timestamp: Type: string SOLANA ROUTES (http://api.neura402.xyz/solana/): ----------- Payment network: Solana GET /token/* ============ Price: $0.0004 Network: solana Description: Get detailed token information including metadata, social links, market data, and network information Input Schema: Method: GET Output Schema: Type: object Properties: success: Type: boolean data: Type: object Type: object Properties: address: Type: string symbol: Type: string name: Type: string decimals: Type: number totalSupply: Type: string networkId: Type: number networkName: Type: string logoUrl: Type: string description: Type: string website: Type: string twitter: Type: string discord: Type: string telegram: Type: string github: Type: string coingeckoId: Type: string marketCap: Type: number volume24h: Type: number priceChange24h: Type: number lastUpdated: Type: string id: Type: string cmcId: Type: number createBlockNumber: Type: number createTransactionHash: Type: string createdAt: Type: number creatorAddress: Type: string freezable: Type: string isFreezableValid: Type: boolean isMintableValid: Type: boolean isScam: Type: boolean mintable: Type: string exchanges: Type: array info: Type: object launchpad: Type: object socialLinks: Type: object error: Type: string timestamp: Type: string POST /balances ============== Price: $0.0004 Network: solana Description: Get token balances for a wallet address across specified networks Input Schema: Method: POST Body Type: json Body Fields: walletAddress: string networks: array Output Schema: Type: object Properties: success: Type: boolean data: Type: object Description: Balance data organized by network error: Type: string timestamp: Type: string GET /networks ============= Price: $0.0004 Network: solana Description: Get information about all supported blockchain networks including their IDs, names, symbols, and chain IDs Input Schema: Method: GET Output Schema: Type: object Properties: success: Type: boolean data: Type: object Type: object Properties: networks: Type: array Items: Type: object Properties: id: Type: number name: Type: string symbol: Type: string chainId: Type: number isActive: Type: boolean lastUpdated: Type: string total: Type: number lastUpdated: Type: string error: Type: string timestamp: Type: string GET /tokens/* ============= Price: $0.0004 Network: solana Description: Search for tokens by name, symbol, or address across all supported networks, or get top 10 token holders Input Schema: Method: GET Query Parameters: q: string limit: string Output Schema: Type: object Properties: success: Type: boolean data: Type: object Type: object Properties: tokens: Type: array Items: Type: object Properties: id: Type: string address: Type: string symbol: Type: string name: Type: string decimals: Type: number networkId: Type: number networkName: Type: string logoUrl: Type: string description: Type: string website: Type: string twitter: Type: string discord: Type: string telegram: Type: string github: Type: string coingeckoId: Type: string marketCap: Type: number volume24h: Type: number priceChange24h: Type: number lastUpdated: Type: string total: Type: number query: Type: string lastUpdated: Type: string holders: Type: array Items: Type: object Properties: address: Type: string balance: Type: string percentage: Type: number rank: Type: number tokenId: Type: string totalHolders: Type: number error: Type: string timestamp: Type: string GET /bars ========= Price: $0.0004 Network: solana Description: Get historical price bars (OHLCV data) for a specific token symbol over a time range Input Schema: Method: GET Query Parameters: symbol: string from: string to: string resolution: string removeLeadingNullValues: string Output Schema: Type: object Properties: success: Type: boolean data: Type: object Type: object Properties: bars: Type: array Items: Type: object Properties: t: Type: number Description: timestamp c: Type: number Description: close h: Type: number Description: high l: Type: number Description: low o: Type: number Description: open volume: Type: number symbol: Type: string resolution: Type: string from: Type: number to: Type: number lastUpdated: Type: string error: Type: string timestamp: Type: string GET /launchpads/new =================== Price: $0.0004 Network: solana Description: Get new launchpad tokens that are not completed and not migrated, sorted by creation date (newest first) Input Schema: Method: GET Output Schema: Type: object Properties: success: Type: boolean data: Type: object Type: object Properties: filterTokens: Type: object Type: object Properties: results: Type: array Items: Type: object Properties: createdAt: Type: number marketCap: Type: number priceUSD: Type: number token: Type: object Type: object Properties: name: Type: string symbol: Type: string address: Type: string networkId: Type: number launchpad: Type: object Type: object Properties: graduationPercent: Type: number launchpadName: Type: string launchpadProtocol: Type: string migrated: Type: boolean completed: Type: boolean completedAt: Type: string error: Type: string timestamp: Type: string GET /launchpads/completing ========================== Price: $0.0004 Network: solana Description: Get launchpad tokens that are 80-100% complete but not yet fully completed or migrated, sorted by graduation percent (highest first) Input Schema: Method: GET Output Schema: Type: object Properties: success: Type: boolean data: Type: object Type: object Properties: filterTokens: Type: object Type: object Properties: results: Type: array Items: Type: object Properties: createdAt: Type: number marketCap: Type: number priceUSD: Type: number token: Type: object Type: object Properties: name: Type: string symbol: Type: string address: Type: string networkId: Type: number launchpad: Type: object Type: object Properties: graduationPercent: Type: number launchpadName: Type: string launchpadProtocol: Type: string migrated: Type: boolean completed: Type: boolean completedAt: Type: string error: Type: string timestamp: Type: string GET /launchpads/completed ========================= Price: $0.0004 Network: solana Description: Get completed launchpad tokens that have been migrated and reached 100% graduation, sorted by migration date (newest first) Input Schema: Method: GET Output Schema: Type: object Properties: success: Type: boolean data: Type: object Type: object Properties: filterTokens: Type: object Type: object Properties: results: Type: array Items: Type: object Properties: createdAt: Type: number marketCap: Type: number priceUSD: Type: number token: Type: object Type: object Properties: name: Type: string symbol: Type: string address: Type: string networkId: Type: number launchpad: Type: object Type: object Properties: graduationPercent: Type: number launchpadName: Type: string launchpadProtocol: Type: string migrated: Type: boolean completed: Type: boolean completedAt: Type: string error: Type: string timestamp: Type: string BASE ROUTES (http://api.neura402.xyz/base/): ----------- Payment network: Base GET /token/* ============ Price: $0.0004 Network: base Description: Get detailed token information including metadata, social links, market data, and network information Input Schema: Method: GET Output Schema: Type: object Properties: success: Type: boolean data: Type: object Type: object Properties: address: Type: string symbol: Type: string name: Type: string decimals: Type: number totalSupply: Type: string networkId: Type: number networkName: Type: string logoUrl: Type: string description: Type: string website: Type: string twitter: Type: string discord: Type: string telegram: Type: string github: Type: string coingeckoId: Type: string marketCap: Type: number volume24h: Type: number priceChange24h: Type: number lastUpdated: Type: string id: Type: string cmcId: Type: number createBlockNumber: Type: number createTransactionHash: Type: string createdAt: Type: number creatorAddress: Type: string freezable: Type: string isFreezableValid: Type: boolean isMintableValid: Type: boolean isScam: Type: boolean mintable: Type: string exchanges: Type: array info: Type: object launchpad: Type: object socialLinks: Type: object error: Type: string timestamp: Type: string POST /balances ============== Price: $0.0004 Network: base Description: Get token balances for a wallet address across specified networks Input Schema: Method: POST Body Type: json Body Fields: walletAddress: string networks: array Output Schema: Type: object Properties: success: Type: boolean data: Type: object Description: Balance data organized by network error: Type: string timestamp: Type: string GET /networks ============= Price: $0.0004 Network: base Description: Get information about all supported blockchain networks including their IDs, names, symbols, and chain IDs Input Schema: Method: GET Output Schema: Type: object Properties: success: Type: boolean data: Type: object Type: object Properties: networks: Type: array Items: Type: object Properties: id: Type: number name: Type: string symbol: Type: string chainId: Type: number isActive: Type: boolean lastUpdated: Type: string total: Type: number lastUpdated: Type: string error: Type: string timestamp: Type: string GET /tokens/* ============= Price: $0.0004 Network: base Description: Search for tokens by name, symbol, or address across all supported networks, or get top 10 token holders Input Schema: Method: GET Query Parameters: q: string limit: string Output Schema: Type: object Properties: success: Type: boolean data: Type: object Type: object Properties: tokens: Type: array Items: Type: object Properties: id: Type: string address: Type: string symbol: Type: string name: Type: string decimals: Type: number networkId: Type: number networkName: Type: string logoUrl: Type: string description: Type: string website: Type: string twitter: Type: string discord: Type: string telegram: Type: string github: Type: string coingeckoId: Type: string marketCap: Type: number volume24h: Type: number priceChange24h: Type: number lastUpdated: Type: string total: Type: number query: Type: string lastUpdated: Type: string holders: Type: array Items: Type: object Properties: address: Type: string balance: Type: string percentage: Type: number rank: Type: number tokenId: Type: string totalHolders: Type: number error: Type: string timestamp: Type: string GET /bars ========= Price: $0.0004 Network: base Description: Get historical price bars (OHLCV data) for a specific token symbol over a time range Input Schema: Method: GET Query Parameters: symbol: string from: string to: string resolution: string removeLeadingNullValues: string Output Schema: Type: object Properties: success: Type: boolean data: Type: object Type: object Properties: bars: Type: array Items: Type: object Properties: t: Type: number Description: timestamp c: Type: number Description: close h: Type: number Description: high l: Type: number Description: low o: Type: number Description: open volume: Type: number symbol: Type: string resolution: Type: string from: Type: number to: Type: number lastUpdated: Type: string error: Type: string timestamp: Type: string GET /launchpads/new =================== Price: $0.0004 Network: base Description: Get new launchpad tokens that are not completed and not migrated, sorted by creation date (newest first) Input Schema: Method: GET Output Schema: Type: object Properties: success: Type: boolean data: Type: object Type: object Properties: filterTokens: Type: object Type: object Properties: results: Type: array Items: Type: object Properties: createdAt: Type: number marketCap: Type: number priceUSD: Type: number token: Type: object Type: object Properties: name: Type: string symbol: Type: string address: Type: string networkId: Type: number launchpad: Type: object Type: object Properties: graduationPercent: Type: number launchpadName: Type: string launchpadProtocol: Type: string migrated: Type: boolean completed: Type: boolean completedAt: Type: string error: Type: string timestamp: Type: string GET /launchpads/completing ========================== Price: $0.0004 Network: base Description: Get launchpad tokens that are 80-100% complete but not yet fully completed or migrated, sorted by graduation percent (highest first) Input Schema: Method: GET Output Schema: Type: object Properties: success: Type: boolean data: Type: object Type: object Properties: filterTokens: Type: object Type: object Properties: results: Type: array Items: Type: object Properties: createdAt: Type: number marketCap: Type: number priceUSD: Type: number token: Type: object Type: object Properties: name: Type: string symbol: Type: string address: Type: string networkId: Type: number launchpad: Type: object Type: object Properties: graduationPercent: Type: number launchpadName: Type: string launchpadProtocol: Type: string migrated: Type: boolean completed: Type: boolean completedAt: Type: string error: Type: string timestamp: Type: string GET /launchpads/completed ========================= Price: $0.0004 Network: base Description: Get completed launchpad tokens that have been migrated and reached 100% graduation, sorted by migration date (newest first) Input Schema: Method: GET Output Schema: Type: object Properties: success: Type: boolean data: Type: object Type: object Properties: filterTokens: Type: object Type: object Properties: results: Type: array Items: Type: object Properties: createdAt: Type: number marketCap: Type: number priceUSD: Type: number token: Type: object Type: object Properties: name: Type: string symbol: Type: string address: Type: string networkId: Type: number launchpad: Type: object Type: object Properties: graduationPercent: Type: number launchpadName: Type: string launchpadProtocol: Type: string migrated: Type: boolean completed: Type: boolean completedAt: Type: string error: Type: string timestamp: Type: string RESPONSE FORMAT: ============== All API responses follow this standard format: { "success": boolean, "data": object | array, // The actual response data "error": string | null, // Error message if success is false "timestamp": string // ISO 8601 timestamp } ERROR RESPONSES: -------------- - 400: Bad Request - Invalid parameters - 429: Rate Limit Exceeded - Includes retryAfter field - 500: Internal Server Error - Server-side error phrase EXAMPLES: ======== 1. Get Token Info: GET http://api.neura402.xyz/token/0xA0b86a33E6441b8C4C8C0E4b8b8C4C8C0E4b8b8C4/1 2. Search Tokens: GET http://api.neura402.xyz/tokens/search?q=bitcoin&limit=10 3. Get Wallet Balances: POST http://api.neura402.xyz/balances Body: { "walletAddress": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6", "networks": [1, 56, 137] } 4. Get Networks: GET http://api.neura402.xyz/networks 5. Get Price Bars: GET http://api.neura402.xyz/bars?symbol=BTC&from=1640995200&to=1641081600&resolution=1D 6. Get Top 10 Holders: GET http://api.neura402.xyz/token/ethereum:0xA0b86a33E6441b8C4C8C0E4b8b8C4C8C0E4b8b8C4/top10holders NOTES: ====== - All routes support wildcard patterns (/*) for flexible token addresses - Payment is handled automatically via X402 middleware - Use /solana/* prefix for explicit Solana payments - Use /base/* prefix for explicit Base payments - All timestamps are Unix timestamps (seconds) unless otherwise specified - All monetary values are in USD